Tempo MCP Server

🚀 Tempo MCP 服務器

Tempo MCP 服務器是一個基於 Go 語言實現的服務器，它遵循 Model Context Protocol（MCP），能夠實現與 Grafana Tempo 的集成。該服務器允許 AI 助手查詢和分析來自 Grafana Tempo 的分佈式跟蹤數據，為數據分析和處理提供了便利。

🚀 快速開始

先決條件

• Go 1.21 或更高版本
• Docker 和 Docker Compose（用於本地測試）

構建和運行

構建並運行服務器：

# 構建項目
go build

# 運行服務器
./tempo-mcp-server

✨ 主要特性

• 支持 AI 助手查詢和分析來自 Grafana Tempo 的分佈式跟蹤數據。
• 遵循 Model Context Protocol（MCP），可與兼容的 AI 客戶端（如 Claude Desktop）配合使用。
• 提供 HTTP 和 WebSocket 端點，方便不同方式的訪問。
• 支持 Docker 部署，便於快速搭建和測試。

📦 安裝指南

本地構建運行

# 構建項目
go build

# 運行服務器
./tempo-mcp-server

Docker 部署

# 構建 Docker 鏡像
docker build -t tempo-mcp-server .

# 運行 Docker 容器
docker run -p 8080:8080 tempo-mcp-server

📚 詳細文檔

服務器端點

• HTTP 端點：http://localhost:8080
• WebSocket 端點：ws://localhost:8080/ws

項目結構

tempo-mcp-server/
├── main.go                 # 主程序入口
├── server.go               # 服務器實現
├── handler.go              # 請求處理邏輯
└── docker/Dockerfile      # Docker 配置文件

MCP 服務器工具定義

tempo_query

• 描述：用於查詢 Grafana Tempo 的跟蹤數據。
• 必填參數：
  • query：要執行的查詢語句。
• 可選參數：
  • limit：限制返回的結果數量（默認值為 10）。

環境變量

• TEMPO_SERVER_ADDR：指定服務器的監聽地址（默認值為 localhost:8080）。
• TEMPO_SERVER_DEBUG：啟用調試模式（默認值為 false）。

💻 使用示例

基礎用法

配置完成後，您可以在 Claude 中使用以下查詢：

• “使用 {duration>1s} 查詢 Tempo 的跟蹤數據”
• “查找前端服務在 Tempo 中的跟蹤記錄，使用查詢 {service.name=\"frontend\"}”
• “顯示最近的 50 條滿足 {http.status_code=500} 的 Tempo 跟蹤記錄”

集成使用

與 Claude Desktop 集成

1. 打開 Claude Desktop 的配置文件。
2. 添加以下內容到 mcpServers 部分：

{
  "tempo-mcp-server": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "-e", "TEMPO_URL=http://host.docker.internal:8080", "tempo-mcp-server:latest"]
  }
}

3. 保存文件並重啟 Claude Desktop。

與 Cursor 集成

1. 打開 Cursor 的設置。
2. 添加以下內容到 mcpServers 部分：

{
  "tempo-mcp-server": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "-e", "TEMPO_URL=http://host.docker.internal:8080", "tempo-mcp-server:latest"]
  }
}

3. 保存設置。

與 n8n 集成

1. 在 n8n 中添加一個 MCP 客戶端工具 節點。
2. 配置節點，如下所示：

• SSE 端點：http://your-server-address:8080/sse
• 身份驗證：選擇適當的認證方式
• 包含的工具：選擇要暴露給 AI 代理的工具

3. 將 MCP 客戶端工具節點連接到支持的 AI 代理節點（如 Claude）。

📄 許可證

本項目在 MIT 許可證下發布。