Grafana MCP server

Grafana MCP server

用于Grafana的MCP Server。

介绍

Grafana MCP 服务器是一个 Model Context Protocol 实现,允许 AI 模型与您的 Grafana 实例交互。

核心功能

  • ✅ 仪表板搜索和访问
  • ✅ 数据源管理和查询(Prometheus、Loki、Tempo、Pyroscope)
  • ✅ 事件管理(搜索、创建、更新、关闭)
  • ✅ 告警管理(规则操作和通知)
  • ✅ 元数据访问

快速安装

  1. 创建服务账户:在 Grafana 中创建具有所需权限的服务账户,并生成令牌。

  2. 安装服务器

    # 使用预编译的二进制文件
    # 从 https://github.com/grafana/mcp-grafana/releases 下载
    
    # 或通过 Go 安装
    GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest
    
  3. 配置 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_rulesIl出告警规则

开发与贡献

# 运行服务器
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.