MCP Grafana

🚀 Grafana 使用文檔

Grafana 是一款功能強大的開源監控與可視化平臺，支持多種數據源，具備豐富的圖表和報警功能。mcp-grafana 工具則為其與 Model Context Protocol (MCP) 的集成提供便利，可通過 MCP 協議與 Grafana 服務交互。

🚀 快速開始

Grafana 是一個功能強大的開源監控和可視化平臺，支持多種數據源，並提供豐富的圖表和報警功能。mcp-grafana 工具則能方便其與 MCP 集成，實現與 Grafana 服務的交互。

✨ 主要特性

• 支持多種數據源，提供豐富的圖表和報警功能。
• 提供 mcp-grafana 工具，方便與 MCP 集成。

📦 安裝指南

創建服務賬號並獲取 API Token

在 Grafana 中創建一個服務賬號，並授予其足夠的權限以使用所需的工具。生成服務賬號令牌，並將其複製到剪貼板中，用於後續配置。詳細步驟請參考 Grafana 文檔。

下載並安裝 mcp-grafana

從 發佈頁面 下載最新版本的 mcp-grafana，並將其添加到系統路徑中。如果使用 Go 工具鏈，可以通過以下命令進行安裝：

GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest

配置服務

將以下配置添加到你的客戶端配置文件中（例如用於 Claude Desktop）：

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": [],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_API_KEY": "<your service account token>"
      }
    }
  }
}

⚠️ 重要提示

如果在 Claude Desktop 中看到 Error: spawn mcp-grafana ENOENT，需要指定完整的 mcp-grafana 路徑。

💻 使用示例

基礎用法

可以通過添加 -debug 標誌啟用調試模式，以獲得詳細的 HTTP 請求和響應日誌。在 Claude Desktop 配置中更新如下：

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["-debug"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_API_KEY": "<your service account token>"
      }
    }
  }
}

🔧 技術細節

開發

歡迎貢獻！如果對項目有建議或改進，請提交問題或拉取請求。

該項目使用 Go 編寫。安裝 Go，請參考相應平臺的說明。

要運行服務器，可以執行：

make run

也可以通過 SSE 傳輸在 Docker 中運行：

make build-image

docker run -it --rm -p 8000:8000 mcp-grafana:latest

測試

有三種類型的測試：

1. 單元測試：驗證單個函數的行為。
2. 集成測試：測試組件間的交互。
3. 雲測試：在雲環境中運行的測試。

執行測試時，請注意以下要求和步驟。

📄 許可證

該項目遵循 MIT License，允許自由使用、修改和分發，但需保留版權聲明。