Grafana MCP 是 Grafana Labs 官方的 MCP 服务器，专为 Claude Code 设计。它让 Claude Code 能够在 Grafana 9.0+ 或 Grafana Cloud 上直接搜索仪表盘、执行 PromQL 与 LogQL 查询、读取告警规则状态，并可查询事件。通过只读模式，开发者不再需要手动复制粘贴查询，提升排障效率。
快速上手
1. 在 Grafana 创建 Viewer 权限的服务账号并复制 token。
2. 在 Claude Code 里执行
```
claude mcp add --scope user --transport stdio grafana \
--env GRAFANA_URL= \
--env GRAFANA_SERVICE_ACCOUNT_TOKEN=<token> \
-- uvx mcp-grafana --disable-write
```
3. 重启 Claude Code，运行claude mcp list确认已连接。整个过程约 5 分钟。
功能概览
- 仪表盘：搜索、摘要、获取单个属性、读取面板查询。
- Prometheus：即时与区间 PromQL 查询，列出指标与标签，计算分位数。
- Loki：LogQL 查询，列出标签，提取日志模式。
- 告警：列出告警规则及状态，读取通知策略。
- 事件：搜索事件，Grafana Cloud 上可执行 Sift 检查。
使用提示
- 只读模式下，--disable-write防止 Claude Code 创建或修改资源。
- 若需写入功能，可将服务账号角色改为 Editor 并去掉--disable-write。
- 旧版 Grafana (<9.0) 会返回 400 “id is invalid”，请升级后再使用。
- 服务器支持 Prometheus、Loki、仪表盘、告警与事件默认开启，可通过--enabled-tools开启其他数据源。
结论
Grafana MCP 为 Claude Code 提供了完整的监控数据访问能力，减少手动操作，提升排障效率。它是开源（Apache 2.0）且免费，适用于自托管或 Grafana Cloud。