grafana/mcp-grafana

如果你已经在用 Grafana，希望让 AI 助手查仪表盘、看数据源配置，而不必在网页里来回点，这个项目值得一试。它是给现有可观测性栈用的工具，不是 Grafana 的替代品。

解决什么问题

你想用 AI 客户端回答一个运维问题：某个仪表盘里有什么面板、查询怎么配置、某个面板最近版本是什么。过去的做法是从 Grafana 网页复制面板 JSON 或手写配置说明，再把答案贴回来。mcp-grafana 把 Grafana API 包装成 MCP 工具，助手可以直接搜索仪表盘、按 UID 获取详情、列出已保存版本、执行面板查询，调查过程留在聊天窗口里，数据仍然来自 Grafana。

有什么不同

它的机制是一个符合 Model Context Protocol 的服务端，在 Claude Desktop、Cursor 等客户端中配置后，把工具调用翻译成 Grafana API 请求。快速开始用 uvx mcp-grafana，配 GRAFANA_URL 和服务账号 token；Docker、二进制和 Helm 也有文档说明。也就是说它只是一座薄桥：助手能做什么取决于服务账号的权限，给账号之前要先想清楚授权范围。

README 建议在不熟悉细粒度 RBAC 时用内置 Editor 角色图方便，但 Editor 提供覆盖大部分操作的广泛读写权限，所以便利性换掉的是最小权限。查询执行则被有意加了开关：run-panel-query 工具默认关闭，必须在 --enabled-tools 里加上 runpanelquery 才能启用。即便如此，Infinity 面板只有使用 backend 或 jq-backend 解析器时才能在服务端执行，默认的 simple 以及 UQL、GROQ 解析器只在浏览器里工作，部分查询无法通过服务端复现。大仪表盘另有提醒：获取完整详情可能占用大量上下文窗口。

谁值得试

适合已经在用 Grafana 9.0 或更高版本、有服务账号流程、并且日常使用聊天式助手（如 Claude Desktop、Cursor）的平台或 SRE 团队。让助手汇总仪表盘、查数据源配置，能省掉不少复制粘贴。不适合仍运行旧版 Grafana 的人：数据源相关操作可能出现 id is invalid 报错，文档给出的解决办法是升级到 9.0 或更高版本。如果希望开箱就能执行查询，或者面板依赖浏览器端解析器，这个项目也不太合适。

使用条件与边界

完整功能要求 Grafana 9.0 或更高版本，更早版本上数据源操作可能失败。快速开始需要安装 uv，Docker、二进制和 Helm 可以绕开这个要求，但各有自己的安装成本。认证使用服务账号 token，GRAFANA_API_KEY 已弃用，旧配置应迁移。多组织场景需要设置 GRAFANA_ORG_ID 或 X-Grafana-Org-Id 请求头。

匿名使用统计默认开启：每个服务进程每 4 小时上报一次，关闭时再报一次，内容涉及工具名、失败次数和配置，不包含参数、查询和凭据。用 --usage-stats=disabled、GRAFANA_USAGE_STATS=disabled 或 DO_NOT_TRACK=1 可以关闭，GRAFANA_USAGE_STATS=log 则只打印将要发送的内容。日常维护的重点是随着使用范围扩大，持续核对服务账号的权限。

HotRepo 点评

HotRepo 唯一有日期的观测是 2026-10-27 登上日榜一次，当天 3,611 stars、+10；可比较的历史太少，无法判断关注度能否持续。采用前建议对照你要让助手调用的具体工具，检查服务账号权限模型是否匹配。项目 README · 安装与使用方式 · Grafana 服务账号文档