Grafana MCP server
用于Grafana的MCP Server。
介绍
Grafana MCP 服务器是一个 Model Context Protocol 实现,允许 AI 模型与您的 Grafana 实例交互。
核心功能
- ✅ 仪表板搜索和访问
- ✅ 数据源管理和查询(Prometheus、Loki、Tempo、Pyroscope)
- ✅ 事件管理(搜索、创建、更新、关闭)
- ✅ 告警管理(规则操作和通知)
- ✅ 元数据访问
快速安装
-
创建服务账户:在 Grafana 中创建具有所需权限的服务账户,并生成令牌。
-
安装服务器:
# 使用预编译的二进制文件 # 从 https://github.com/grafana/mcp-grafana/releases 下载 # 或通过 Go 安装 GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest
-
配置 MCP 客户端(示例:Claude Desktop):
{ "mcpServers": { "grafana": { "command": "mcp-grafana", "args": [], "env": { "GRAFANA_URL": "http://localhost:3000", "GRAFANA_API_KEY": "<your-service-account-token>" } } } }
注意:如遇
ENOENT
错误,请使用mcp-grafana
的完整路径。
工具示例
常用工具 | 描述 |
---|---|
search_dashboards | 搜索仪表板 |
query_prometheus | 执行 Prometheus 查询 |
query_loki_logs | 执行 Loki 日志查询 |
list_incidents | 查看事件列表 |
list_alert_rules | Il出告警规则 |
开发与贡献
# 运行服务器
make run
# 测试
make test
# 代码检查
make lint
# Docker 支持
make build-image
docker run -it --rm -p 8000:8000 mcp-grafana:latest
更多信息
完整工具列表和详细文档请访问 GitHub 项目页面。
Licensed under Apache License, Version 2.0.