Grafana MCP：先列出資料源，不要一上來拉取整張大盤

適合誰

適合已經有 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 與資料源都不是零風險：服務帳號能看到的儀表板與資料源，模型也能看到。不要把「唯讀列出資料源」理解成不會出網或不會讀到敏感指標名。