grafana-mcp

christian-schlichtherle/grafana-mcp

3.3

If you are the rightful owner of grafana-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This repository provides an MCP (Model Context Protocol) server for the comprehensive discovery, editing, and testing of dashboards and folders in one or more Grafana clusters.

The Grafana MCP server is designed to facilitate the management of dashboards and folders across multiple Grafana clusters. It offers a robust security model based on labels and folders, ensuring that only authorized modifications are made to dashboards. The server supports a wide range of operations, including discovery, editing, and testing of Grafana resources. It allows for unrestricted reading of dashboards, enabling users to enhance existing dashboards by copying them. The server also supports multi-cluster management, allowing users to handle dashboards across different Grafana instances seamlessly. With comprehensive search capabilities, users can filter and find specific dashboards and folders efficiently. The server is easy to set up and can be configured to work with both authenticated and unauthenticated Grafana instances, making it versatile for various environments.

Features

  • Dashboard Protection: Ensures that only dashboards with required protection labels can be updated or deleted.
  • Selective Modification: Allows modifications only on dashboards with specific protection labels.
  • Unrestricted Reading: Provides unrestricted access to read dashboards, facilitating enhancement through copying.
  • Folder Restrictions: Offers configurable access control to specific folders and subfolders.
  • Multi-Cluster Support: Enables management of dashboards across multiple Grafana instances.

Usages

usage with local development

python
uv sync
python main.py

usage with docker

bash
docker run -d \
  -p 3000:3000 \
  -e "GF_AUTH_ANONYMOUS_ENABLED=true" \
  -e "GF_AUTH_ANONYMOUS_ORG_ROLE=Admin" \
  -e "GF_AUTH_BASIC_ENABLED=false" \
  --name grafana \
  grafana/grafana:latest

python main.py

Tools

  1. Discovery

    Discover and explore Grafana resources across clusters.

  2. Editing

    Create, modify, and manage Grafana resources with security controls.

  3. Testing

    Validate, test, and analyze dashboard quality and data accuracy.