安装
uvx mcp-grafana适合谁
适合已经有 Grafana 9.0 或更新实例、想让模型查看实例与周边生态（仪表盘、数据源）的人。证据写明：这台 MCP 提供对 Grafana 实例及周围生态的访问。
你必须能提供 GRAFANA_URL 和服务账号令牌 GRAFANA_SERVICE_ACCOUNT_TOKEN。低于 9.0 时，部分功能（尤其数据源相关）可能因缺少 API 而不可用。
证据没有列出客户端名单，也没有写出大多数工具的函数名。第一次只做只读查看，不要启用默认关闭的 panel query，也不要把 localhost:3000 示例原样用在生产。
3 分钟完成第一次尝试
走 uvx 主路径。在客户端配置：
"command": "uvx",
"args": ["mcp-grafana"],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}
把 URL 换成你的实例，令牌换成服务账号 token。不要写进对话。
前置条件：Grafana ≥ 9.0 可访问；服务账号权限足够列出数据源或读仪表盘。这次会带令牌访问你的 Grafana，不是无网络沙箱。
配置位置：客户端 MCP 的 command / args / env。
低风险第一次调用：先「列出并获取数据源信息」（证据能力），不要先按 UID 拉取整张大仪表盘。Run panel query 工具默认关闭；不要为了第一次尝试把 runpanelquery 加进 --enabled-tools。
成功信号：客户端连上后能看到已配置数据源列表。若 401 或连不上，先核 URL 与令牌，以及实例是否 ≥ 9.0。
使用案例
案例 1：看实例配了哪些数据源。使用「List and fetch datasource information」。证据写明支持的类型包括 Prometheus、Loki、ClickHouse、CloudWatch、Elasticsearch、OpenSearch、Snowflake、Athena。没有给出工具函数名或过滤参数。因此能确认的是：你看到已配置数据源及其详情为止。
案例 2：按 UID 取一张仪表盘的完整详情。证据发出警告：大仪表盘会占用大量上下文窗口。先选一张你知道 UID、且不巨大的盘；若返回过长，停在「证据已警告上下文占用」，不要反复全量拉取。证据没有写 JSONPath 精简工具的 locator 原文，不要编造替代工具名。
使用边界
需要 Grafana 9.0+、GRAFANA_URL 与服务账号令牌。runpanelquery 默认禁用，启用后才会跑 panel query。按 UID 取整盘可能撑爆上下文。数据源类型仅列出上述几种。证据没有 undo、没有完整工具名表，也没有说令牌最小权限。访问 Grafana 与数据源都不是零风险：服务账号能看到的仪表盘与数据源，模型也能看到。不要把「只读列出数据源」理解成不会出网或不会读到敏感指标名。