Grafana MCP服务器

简介

MCP服务器是Grafana的模型上下文协议（Model Context Protocol）实现，用于集成各类工具与功能，支持事件管理、监控数据查询、仪表板操作等场景。什么是MCP服务器？

特性

属性	详情
Docker镜像	mcp/grafana
作者	grafana
代码仓库	[***]
Dockerfile	[***]
镜像构建方	Docker Inc.
Docker Scout健康评分	!Docker Scout健康评分
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/grafana --key [***]`
许可证	Apache License 2.0

Docker部署方案

基本部署命令

bash
docker run -d \
  --name grafana-mcp-server \
  -p 8080:8080 \
  -e GRAFANA_URL="[***]" \
  -e MCP_API_KEY="your-secure-api-key" \
  mcp/grafana:latest

参数说明

端口映射：-p 8080:8080 映射容器8080端口至主机，用于MCP服务通信
环境变量：
- GRAFANA_URL：Grafana实例地址，必填
- MCP_API_KEY：Grafana API访问密钥，用于权限验证
- 其他可选变量：LOG_LEVEL（日志级别，默认info）、REQUEST_TIMEOUT（请求超时时间，默认30s）

可用工具概览

服务器提供47种工具，覆盖事件管理、日志分析、监控查询等功能，核心工具列表如下：

工具名称	简短描述
`add_activity_to_incident`	向事件添加活动
`create_folder`	创建文件夹
`create_incident`	创建事件
`fetch_pyroscope_profile`	获取Pyroscope性能分析数据
`find_error_pattern_logs`	在日志中查找错误模式
`find_slow_requests`	查找慢请求
`generate_deeplink`	生成导航深度链接
`get_alert_group`	获取IRM告警组
`get_alert_rule_by_uid`	获取告警规则详情
`get_current_oncall_users`	获取当前值班用户
`get_dashboard_by_uid`	获取仪表板详情
`get_datasource_by_name`	按名称获取数据源
`get_incident`	获取事件详情
`list_alert_rules`	列出告警规则
`list_datasources`	列出数据源
`query_loki_logs`	查询Loki日志
`query_prometheus`	查询Prometheus指标
...	...（完整列表含47个工具）

工具详细说明

`create_incident`

创建新的Grafana事件，需提供标题、严重性和房间前缀，支持设置状态和标签。使用前需用户确认，避免误触发大量通知。

参数	类型	描述
`title`	`string` 可选	事件标题
`severity`	`string` 可选	事件严重性
`roomPrefix`	`string` 可选	事件所属房间前缀
`status`	`string` 可选	事件状态
`labels`	`array` 可选	事件标签
`isDrill`	`boolean` 可选	是否为演练事件

`fetch_pyroscope_profile`

从Pyroscope数据源获取指定时间范围的性能分析数据，默认查询过去1小时。需指定分析类型（通过list_pyroscope_profile_types获取），支持Prometheus风格匹配器过滤。

参数	类型	描述
`data_source_uid`	`string`	数据源UID
`profile_type`	`string`	分析类型（必填）
`start_rfc_3339`	`string` 可选	开始时间（RFC3339格式，默认1小时前）
`end_rfc_3339`	`string` 可选	结束时间（RFC3339格式，默认当前时间）
`matchers`	`string` 可选	过滤匹配器（如`{service_name="api"}`）

此工具为只读，不会修改环境。

`query_prometheus`

查询Prometheus指标数据，支持时间范围、查询表达式和数据源指定。返回Prometheus原生格式结果。

参数	类型	描述
`datasource_uid`	`string`	Prometheus数据源UID
`query`	`string`	PromQL查询表达式
`start`	`string` 可选	开始时间（RFC3339格式）
`end`	`string` 可选	结束时间（RFC3339格式）
`step`	`string` 可选	采样步长（如"15s"）