MCP服务器是Grafana的模型上下文协议(Model Context Protocol)实现,用于集成各类工具与功能,支持事件管理、监控数据查询、仪表板操作等场景。什么是MCP服务器?
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/grafana |
| 作者 | https://github.com/grafana |
| 代码仓库 | https://github.com/grafana/mcp-grafana |
| Dockerfile | https://github.com/grafana/mcp-grafana/blob/main/Dockerfile |
| 镜像构建方 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout健康评分 |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/grafana --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | Apache License 2.0 |
bashdocker run -d \ --name grafana-mcp-server \ -p 8080:8080 \ -e GRAFANA_URL="http://your-grafana-instance:3000" \ -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") |
此工具为只读,不会修改环境。
以下是 mcp/grafana 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务