用途：Grafana MCP Server 是一个 MCP 服务器，向 AI 客户端暴露 50+ 个 Grafana API 工具，支持 Grafana 9.0+（本地与 Grafana Cloud）。前提是该服务器已安装，不要自动安装；若不可用应提示用户先安装。安装说明、预编译二进制、Docker 镜像与 Helm chart 见 github.com/grafana/mcp-grafana。
配置：环境变量包括 GRAFANA_URL（默认 http://localhost:3000）、GRAFANA_SERVICE_ACCOUNT_TOKEN（推荐）、GRAFANA_API_KEY（已弃用）、GRAFANA_USERNAME + GRAFANA_PASSWORD、GRAFANA_ORG_ID、GRAFANA_EXTRA_HEADERS。步骤：在 Grafana 创建至少 Viewer 角色（写操作需 Editor）的服务账号并生成令牌，然后设置环境变量，例如 export GRAFANA_URL="https://mystack.grafana.net" 与 export GRAFANA_SERVICE_ACCOUNT_TOKEN="glsa_..."。Docker 连接本地 Grafana 时使用 host.docker.internal。也可用二进制方式在 mcp.json 中配置 command 为 mcp-grafana。CLI 标志包括 -t/--transport（stdio、sse、streamable-http）、--address、--debug、--log-level、--disable-write（只读）、--enabled-tools、--metrics。
主要能力：仪表盘（搜索、摘要、JSONPath 提取、面板查询、更新与 patch）、数据源、Prometheus（PromQL、指标元数据、标签、直方图）、Loki（LogQL、标签、统计、模式）、告警规则与联系人、事件、OnCall、Sift 调查、Pyroscope 性能分析、注解、导航深链、面板渲染。默认禁用需用 --enabled-tools 显式启用的类别：ClickHouse、CloudWatch、Elasticsearch、Admin、Search Logs、Query Examples。
最佳实践：用 get_dashboard_summary 替代 get_dashboard_by_uid 以节省上下文；用 get_dashboard_property 按需提取；优先 patch_dashboard；查询前先做数据源发现；Prometheus 查询指定合理时间范围；Loki 使用带标签匹配的精确选择器；展示数据时用 generate_deeplink 生成可点击 URL。安全：非明确要求避免写操作，可用 --disable-write 只读，禁用未用类别以减少攻击面。RBAC：Viewer 足够读操作，Editor 用于写操作，细粒度可用自定义角色。限制：面板图像渲染需 Image Renderer；部分工具类别默认禁用；具体 RBAC 矩阵见 mcp-grafana README。