mcp-grafana

Grafana MCP 服务器是一个 Model Context Protocol (MCP) 服务器，用于将 Claude Desktop 或 Cursor 等 MCP 客户端连接到 Grafana 实例及其周边生态。它需要 Grafana 9.0 或更高版本才能提供完整功能，因为部分数据源操作依赖较新的 API 端点。 设置方式是在 MCP 客户端配置中添加一个条目，通常通过 uvx 运行服务器，并在环境中提供 GRAFANA_URL 和服务账户令牌。文档还介绍了 Docker、二进制和 Helm 安装选项。 功能按工具类别分组，工具列表可配置，因此可以禁用未使用的功能以节省上下文窗口空间。可以使用 --disable-oncall 或 --disable-navigation 等标志关闭类别，并且若干类别默认禁用，必须通过 --enabled-tools 显式启用。 仪表盘工具涵盖按标题、文件夹 UID、标签或星标状态搜索；按 UID 或已保存版本获取仪表盘；列出版本；获取紧凑摘要；通过 JSONPath 提取部分内容；创建、更新和修补仪表盘；以及读取面板查询及其数据源信息。README 指出，完整仪表盘 JSON 可能占用大量上下文窗口空间，并建议改用摘要或 JSONPath 工具。 数据源和查询支持包括列出和检查数据源（Prometheus、Loki、ClickHouse、CloudWatch、Elasticsearch、OpenSearch、Snowflake、Athena），PromQL 即时查询和范围查询以及指标元数据和直方图百分位数，LogQL 日志和指标查询及标签和模式发现，通过 InfluxQL 或 Flux 使用 InfluxDB，面向 ClickHouse、Snowflake、Athena、MySQL、PostgreSQL 和 MSSQL 的统一 SQL 工具（支持宏替换和限制强制执行），CloudWatch 命名空间、指标和维度，Graphite render 查询和指标发现，Elasticsearch/OpenSearch 和 Quickwit 搜索，以及示例查询检索。SQL 查询通过 Grafana 数据源插件运行，因此凭据由数据源配置处理，而不是由 MCP 服务器处理。 运维领域包括告警（列出、创建、更新、删除规则；通知策略、联系点、时间间隔）、Grafana Incident（搜索、创建、更新、自定义字段）、Sift 调查（列表、详情、分析、错误模式和慢请求检测）、Grafana OnCall（排班、轮班、当前值班用户、团队、用户、告警组）、注释（查询、创建、更新、修补、删除、标签）、快照（列出、获取、创建、删除）、通过 Grafana Image Renderer 将面板或仪表盘渲染为 PNG、provisioning 仓库列表和 dry-run 验证、为仪表盘、面板和 Explore 生成 deeplink，以及用于多组织请求的用户身份查找。 仅限 Grafana Cloud 的 Agent Observability 工具涵盖 LLM 对话列表和搜索、带评估分数的对话和生成详情、带版本历史和 token 估算的 agent 目录、评估器和模板、eval 规则和 guards、已保存对话和集合、测试套件，以及离线实验。其中一些包含受特定权限控制的写操作。Grafana Assistant 工具向 assistant 发送自然语言提示，并支持通过返回的上下文 ID 继续对话；它们是写工具，在设置 --disable-write 时会被跳过。 访问控制基于 RBAC：每个工具都需要特定权限和 scope，README 建议创建具有必要授权的服务账户，并指出内置 Editor 角色是更简单但粒度更粗的替代方案。Incident 和 Sift 工具使用基本的 Viewer/Editor 角色，而不是细粒度权限。README 包含一个工具表，将工具名称映射到类别、所需 RBAC 权限和所需 scope。