Grafana MCP — Dashboards, Alerts & OnCall Tools

简介

Grafana MCP server 让 MCP 客户端直连你的 Grafana：用 service account token 搜索仪表盘、读取/更新内容、运行查询并辅助运维自动化，适合把排障步骤变成可重复的“工具链”。

• 适合谁： 希望让 Agent 更高效地导航 Grafana 仪表盘，并安全自动化常见运维读写任务的团队
• 可搭配： Grafana 9.0+、service account token、通过 uvx 或 Docker/Helm 接入 MCP 客户端
• 准备时间： 12 分钟

实战建议

• README 要求 Grafana 9.0+ 才能完整工作
• 工具类别可用 flags 开关；按 README 的 RBAC 建议规划最小权限 scopes

面向可观测性的最小权限模式

把 Grafana token 当成生产凭据对待。

建议步骤：

1. 为 MCP 单独创建 service account。
2. 先只开只读能力（搜索仪表盘、获取摘要）。
3. 等审计链路与误操作风险可控后，再逐步开放写入类工具（patch/update）。

为了控制上下文体积：

• 优先用 summary，而不是拉全量 dashboard JSON。
• 用 property/JSONPath 式的提取只取必要字段。

这样 Agent 才能在不爆上下文的前提下回答“发生了什么 / 哪里坏了”。

FAQ

必须有 Grafana token 吗？ 答：需要，README 使用 GRAFANA_SERVICE_ACCOUNT_TOKEN 作为认证方式。

不装 Docker 也能跑吗？ 答：可以，README 提供 uvx 快速启动，也有 Docker/Helm 选项。

为什么要管上下文大小？ 答：dashboard JSON 很大；用 summary 与字段提取避免 token 爆炸。