mcp-grafana

mcp-grafana 发布 v2.0.2：get_panel_image 新增 explore 输入（数据源 UID 与查询），可直接将临时 Explore 视图渲染为 PNG，无需先保存仪表盘，要求 Grafana 10.2+；update_dashboard 在 url 字段返回仪表盘绝对深链，优先使用 Grafana 公网 URL；修复 query_cloudwatch 只支持基础统计枚举的问题，现接受 p95、p99.9 等百分位统计；工具与参数描述移除模型指令及对其他工具的引用，以满足连接器目录要求。

mcp-grafana 发布 v2.0.1：update_dashboard 引导模型对新建仪表盘采用 schema v2，并保留既有仪表盘的原存储 schema，工具描述内置 v2 网格与标签页布局最小示例；修复 update_dashboard 用 v1 panels[] 结构静默覆盖 v2 仪表盘（导致标签页等结构丢失）的问题，现改为返回错误提示改用补丁或 v2 body，新 v2 仪表盘改用 Grafana 实际提供的最稳定 v2 API 版本而非硬编码 v2beta1；修复 run_panel_query 在 schema v2 仪表盘上误报 dashboard has no panels 的问题；数据源请求不再把 /resources 回退路由返回的 HTML 页面（如 Loki Web UI）当作成功响应，避免 invalid character '<' 错误重启前持续存在；修复工具描述中逗号显示为字面 \, 的问题，并让 trace/panel viewer MCP 应用在 CSP 中声明 data: 资源以兼容 MCP Inspector 等宿主。

mcp-grafana 发布 v2.0.0 大版本：服务器从 mark3labs/mcp-go 迁移到官方 MCP Go SDK，Go 模块路径改为 github.com/grafana/mcp-grafana/v2；告警工具拆分为读写工具（alerting_rules_read/write、alerting_silences_read/write），只读凭据与 --disable-write 可保留读权限；新增 alerting_routing_write 创建 Grafana 托管联系人点；移除已废弃的 Sift 工具类别；SSE 传输不再支持每请求头（Grafana URL/凭据/org ID/转发头），需改用 streamable HTTP；匿名使用统计默认开启，可用 --usage-stats=disabled 或 DO_NOT_TRACK=1 关闭。

mcp-grafana 发布 v1.6.3 补丁版。安全加固：出站 Grafana 客户端默认拒绝指向不同协议、主机或端口的重定向，确保 Grafana 凭据不会被转发到重定向目标，可用 --allow-cross-origin-redirects（或 GRAFANA_ALLOW_CROSS_ORIGIN_REDIRECTS=true）恢复旧行为。修复 Prometheus 返回 400/422 以外错误（如 500 或代理错误）时只显示状态码的问题，现错误信息包含响应体；修复 Docker 镜像报告构建回退版本而非实际发布版本号的问题。

mcp-grafana 发布 v1.6.2，这是最后一个 1.x 版本（下个版本为 2.0）。修复 Loki 日志查询跨流时按时间顺序返回、且结果跨多个流时不再在 limit 边界丢失一行日志；Loki 与 VictoriaLogs 查询时间边界保持亚秒（最高纳秒）精度，窄时间窗可正常返回结果并支持按精确日志时间戳翻页；修复 Grafana URL 带尾斜杠时获取前端设置产生双斜杠路径的问题；PyPI wheel 压缩内置二进制，体积从约 55MB 缩小到约 17MB。

mcp-grafana 发布 v1.6.1 补丁版：修复协议 2026-07-28 下客户端开启 subscriptions/listen 流后 stdio 服务器停止响应、导致 Claude Code 与 GitHub Copilot CLI 等客户端 tools/list 超时的问题；修复 Claude Desktop 扩展（MCPB）可选字段留空时把 ${user_config.*} 占位符当作凭据传递的问题，使服务账号令牌字段为空时用户名/密码认证可正常工作。

mcp-grafana 发布 v1.6.0：新增可选的按请求选择 Grafana URL（含 URL allowlist 与请求级令牌）；新增可选 cloudlogging 工具类别，支持 Google Cloud Logging 数据源查询及项目/桶/视图枚举；Tempo TraceQL metrics 工具提供语法示例与 PromQL 常见错误纠正提示。修复 Prometheus 指标名下推过滤与分页限制、--base-path 对 streamable HTTP/SSE 端点生效、Loki/VictoriaLogs 空查询报错及 get_panel_image 深链结构化返回。

mcp-grafana 发布 v1.5.1 补丁版：修复 shorten_url 在子路径部署实例上重复拼接 Grafana 子路径前缀的问题；get_annotation_tags 的 limit 参数改为数字类型，消除 LLM 调用方的类型不匹配错误；数据源 TLS schema 字段不再包含 PEM 占位字符串，避免 LLM 误将占位文本当作真实证书发送。

mcp-grafana 发布 v1.5.0：新增匿名使用统计上报，按进程统计事件，可用 --usage-stats/GRAFANA_USAGE_STATS 配置 enabled/disabled/log（默认关闭），支持 DO_NOT_TRACK=1，仅上报工具调用次数与服务器配置、无 PII；GrafanaConfig 新增 UserAgent 字段标识出站 API 调用方。修复 query_loki_logs 紧凑输出格式下结构化元数据丢失问题；Tempo 工具改为直连 Tempo API 的 HTTP 调用，不再经 MCP 层代理，提升可靠性并降低开销。

mcp-grafana 发布 v1.4.2：get_dashboard_by_uid 新增可选 version 参数，可获取仪表盘指定的历史保存版本；新增 list_dashboard_versions 工具返回版本号、作者、时间戳、提交信息等版本元数据。修复 tools/list 响应无条件注入 resultType、cacheScope、ttlMs 字段导致按基础协议 schema 校验的旧版 MCP 客户端报错的问题。

mcp-grafana 发布 v1.4.1：Sift 调查工具 find_error_pattern_logs、find_slow_requests 新增 labelSelector 参数，支持 PromQL/LogQL 流选择器语法（正则与负向匹配），替代原必填 labels 映射参数（破坏性变更）；run_panel_query 改为按数据源真实类型路由，修复面板误标 Loki 数据源可绕过 --loki-enforced-matchers 查询限制的安全问题；启用动态多组织支持时启动不再记录默认组织缺失警告。

mcp-grafana 发布 v1.4.0：统一 Athena/ClickHouse/Snowflake/MSSQL/PostgreSQL SQL 数据源工具为共享方言体系；新增 --enable-write-tools 细粒度写工具开关、search_dashboards 的 folderUid/tag/starred 过滤、delete_annotation、list_cloudwatch_dimension_values 等工具；新增 --loki-enforced-matchers 运维侧查询限制、--instructions-append 指令注入与独立 /healthz 监听端口。同时修复 Python MCP 代理下 tools/list 丢工具、IRM 值班用户解析、Explore 深链等问题。