大模型应用
让 AI 编码助手(Claude…
当需要给 AI 编码代理接入 Grafana Cloud 以查询指标、搜索仪表盘、管理告警时,用 mcp-grafana 配置 MCP 服务器。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
让 AI 编码助手(Claude Cod特定
解决思路
- 用 `go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest` 安装服务器,再用 `mcp-grafana --version` 验证二进制;若提示 command not found,确保 $GOPATH/bin(或 $HOME/go/bin)在 PATH 中。
- 在 Grafana Cloud → Administration → Service Accounts 创建服务账号,赋予 `Viewer` 角色(仅在需要写入时加 `Editor`),生成 token,并记下 Grafana URL(如 `https://myorg.grafana.net`)。
- 在 `~/.claude/settings.json`(或项目级 `.claude/settings.json`)中写入 mcpServers 配置:command 为 `mcp-grafana`,args 为 `["--disable-write"]`,env 中设置 `GRAFANA_URL` 与 `GRAFANA_API_KEY`。
- `--disable-write` 作为更安全的默认值,待读路径验证通过后再移除。
- 重启 Claude Code 后用 `/mcp` 验证 grafana 服务器及其工具列表是否出现,再提问“What data sources are configured in my Grafana instance?”确认可用;若失败,检查 `GRAFANA_URL` 无尾部斜杠、API key 未过期,并用 `mcp-grafana --debug` 查看原始请求/响应。
- 连接 Cursor:使用同一 Grafana token,在 Settings → Features → MCP Servers 或编辑 `~/.cursor/mcp.json`,写入相同的 mcpServers 配置(command、args、env)。
- 在 Cursor 的 agent 面板中验证 MCP 服务器,运行如“list dashboards tagged kubernetes”的查询。
- 团队共享时从 stdio 切换到 SSE 传输,使服务器只运行一次、多个 agent 通过 HTTP 连接(VS Code 配置见 references/sse-transport.md)。
- 安全实践:API key 放在环境变量或密钥管理器中,绝不提交到文件;共享环境和 CI 使用 `--disable-write`,仅在允许 agent 修改 Grafana 的特定机器上解除;服务账号权限按最小化授予(查询和读仪表盘用 `Viewer`,仅创建仪表盘或注解时才给 `Editor`);定期通过 Administration → Service Accounts 轮换 token。
适用边界 · 注意事项
- 未安装 Go 工具链或无法将 $GOPATH/bin 加入 PATH 时无法安装 mcp-grafana。
- 没有 Grafana Cloud 账号或无法创建服务账号 token 时无法使用。
- 需要 agent 写入 Grafana 时不能使用 `--disable-write`,且需相应提升服务账号权限。