grafana/mcp-grafana

这是什么？

核心功能

• 01搜索、读取和更新 Grafana 仪表盘，支持通过 JSONPath 提取部分内容并打补丁。
• 02通过 MCP 工具查询 Prometheus、Loki、InfluxDB、Elasticsearch、CloudWatch 及 SQL 数据源。
• 03管理告警规则、通知策略和联系点。
• 04读取并管理 Grafana OnCall 排班与告警分组。
• 05借助 Grafana Image Renderer 将仪表盘面板渲染为 PNG 图片。
• 06通过命令行参数按类别启用或禁用工具。

适用场景

• 让 AI 助手通过查询 Grafana 中的指标和日志辅助排查线上故障。
• 根据自然语言需求生成或修改仪表盘，同时控制上下文占用。
• 通过对话界面检查告警规则和值班排班。
• 为周报或聊天通知生成仪表盘图片。

快速上手

1. 1

   安装 uv（uvx 所需）

2. 2

   在 MCP 客户端配置中添加 Grafana MCP 服务器，并填写 GRAFANA_URL 和服务账户令牌

3. 3

   使用 uvx 运行服务器

   uvx mcp-grafana

使用前须知

• !完整功能需要 Grafana 9.0 或更高版本，较早版本上部分数据源功能可能无法正常工作。
• !许多工具（如运行面板查询、SQL、CloudWatch 和 InfluxDB）默认禁用，需通过 --enabled-tools 手动启用。

标签

常见问题

mcp-grafana 是什么？

让 AI 助手通过 MCP 协议访问 Grafana 仪表盘、数据源、告警和事件的服务器。 mcp-grafana 是一个用 Go 编写的 Model Context Protocol 服务器，可将 Claude Desktop、Cursor 等支持 MCP 的客户端连接到 Grafana 实例。配置 Grafana 地址和服务账号令牌后，AI 助手即可搜索和读取仪表盘、执行面板查询，并查询 Prometheus、Loki、ClickHouse、Elasticsearch、CloudWatch 等已接入的数据源。

mcp-grafana 可以免费使用吗？用的什么许可证？

mcp-grafana 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

mcp-grafana 还在维护吗？

活跃维护中。mcp-grafana 最近一次提交是在 2026年10月22日。

mcp-grafana 适合用来做什么？

让 AI 助手通过查询 Grafana 中的指标和日志辅助排查线上故障。 根据自然语言需求生成或修改仪表盘，同时控制上下文占用。 通过对话界面检查告警规则和值班排班。 为周报或聊天通知生成仪表盘图片。

mcp-grafana 怎么安装和运行？

安装 uv（uvx 所需） 在 MCP 客户端配置中添加 Grafana MCP 服务器，并填写 GRAFANA_URL 和服务账户令牌 使用 uvx 运行服务器: uvx mcp-grafana

在哪里获取 mcp-grafana？

源代码和安装说明在 GitHub 上：https://github.com/grafana/mcp-grafana