Tích hợp Máy chủ Tempo MCP

Máy chủ “Tempo” MCP làm gì?

Tempo MCP Server là một triển khai Model Context Protocol (MCP) bằng Go tích hợp với Grafana Tempo, một backend truy vết phân tán. Máy chủ này cho phép trợ lý AI truy vấn và phân tích dữ liệu truy vết phân tán, giúp nhà phát triển hiểu rõ hiệu năng ứng dụng và truy vết hành vi hệ thống. Bằng cách cung cấp các định nghĩa công cụ tương thích MCP, Tempo MCP Server giúp các ứng dụng AI (như Claude Desktop) thực hiện các tác vụ như truy vấn dữ liệu truy vết, truyền sự kiện thời gian thực và tích hợp thông tin truy vết vào quy trình phát triển. Hỗ trợ đồng thời cả HTTP (với SSE cho cập nhật thời gian thực) và chuẩn nhập/xuất đảm bảo tích hợp linh hoạt với nhiều nền tảng và công cụ, tăng cường khả năng quan sát và gỡ lỗi cho các hệ thống phân tán hiện đại.

Danh sách Prompt

Không tìm thấy template prompt nào trong kho mã.

Danh sách Resource

Không có tài nguyên MCP rõ ràng nào được liệt kê trong kho mã.

Danh sách Công cụ

• Tempo Query Tool
  • Cho phép AI client truy vấn và phân tích dữ liệu truy vết phân tán từ Grafana Tempo. Công cụ này cung cấp quyền truy cập lập trình tới dữ liệu truy vết, giúp kiểm tra sâu hiệu năng cũng như hành vi hệ thống thông qua giao diện MCP.

Các trường hợp sử dụng của MCP Server này

• Phân tích truy vết phân tán
  • Nhà phát triển có thể sử dụng trợ lý AI để truy vấn và trực quan hoá dữ liệu truy vết từ Grafana Tempo, giúp xác định các nút thắt hiệu năng và gỡ lỗi hệ thống phân tán hiệu quả hơn.
• Truyền phát sự kiện thời gian thực
  • Nhờ endpoint SSE, người dùng có thể truyền phát các sự kiện truy vết thời gian thực, dễ dàng giám sát sức khỏe hệ thống và phản hồi nhanh các vấn đề phát sinh.
• Tích hợp với công cụ phát triển AI
  • Máy chủ MCP có thể tích hợp với các AI client như Claude Desktop, cho phép truy vấn truy vết theo ngữ cảnh và tự động hoá các tác vụ quan sát trong quy trình làm việc của lập trình viên.
• Tự động gỡ lỗi
  • Công cụ AI có thể sử dụng dữ liệu truy vết của Tempo để đề xuất giải pháp, làm nổi bật bất thường, hoặc cung cấp tóm tắt quá trình thực thi hệ thống, từ đó tăng tốc độ gỡ lỗi.

Cách thiết lập

Windsurf

1. Đảm bảo đã cài đặt Go 1.21+ và Docker.
2. Biên dịch server:

   go build -o tempo-mcp-server ./cmd/server
   

3. Thêm cấu hình máy chủ MCP vào file cấu hình của Windsurf:

   {
     "mcpServers": {
       "tempo": {
         "command": "./tempo-mcp-server",
         "args": []
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Xác nhận tích hợp bằng cách kết nối AI client tới endpoint máy chủ MCP.

Bảo mật API Key

Sử dụng biến môi trường cho dữ liệu nhạy cảm:

{
  "mcpServers": {
    "tempo": {
      "command": "./tempo-mcp-server",
      "env": {
        "SSE_PORT": "8080"
      },
      "inputs": {}
    }
  }
}

Claude

1. Đảm bảo đã cài đặt Go 1.21+ và Docker.
2. Biên dịch và chạy server như hướng dẫn trên.
3. Sửa cấu hình Claude để thêm:

   {
     "mcpServers": {
       "tempo": {
         "command": "./tempo-mcp-server",
         "args": []
       }
     }
   }
   

4. Khởi động lại Claude và kiểm tra kết nối MCP.

Cursor

1. Cài đặt các điều kiện tiên quyết (Go, Docker).
2. Biên dịch và chạy tempo-mcp-server.
3. Cập nhật cấu hình của Cursor với:

   {
     "mcpServers": {
       "tempo": {
         "command": "./tempo-mcp-server",
         "args": []
       }
     }
   }
   

4. Khởi động lại Cursor và xác minh máy chủ MCP đã xuất hiện như một công cụ.

Cline

1. Cài đặt Go 1.21+ và Docker.
2. Biên dịch/chạy server bằng go build hoặc Docker.
3. Thêm vào cấu hình MCP servers của Cline:

   {
     "mcpServers": {
       "tempo": {
         "command": "./tempo-mcp-server",
         "env": {
           "SSE_PORT": "8080"
         }
       }
     }
   }
   

4. Lưu thay đổi và khởi động lại Cline.
5. Xác nhận kết nối với máy chủ MCP ở cổng đã chỉ định.

Cách sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào workflow FlowHunt, hãy thêm thành phần MCP vào flow của bạn và kết nối nó với AI agent:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, điền thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "tempo": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, AI agent có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Nhớ thay “tempo” thành tên thực tế của máy chủ MCP và thay URL bằng URL máy chủ của bạn.

Tổng quan

Dựa trên các dữ liệu trên, Tempo MCP Server cung cấp tích hợp thực tiễn cho truy vết phân tán với Grafana Tempo, nhưng thiếu template prompt MCP và định nghĩa resource đầy đủ, cũng như không hỗ trợ rõ ràng sampling hoặc roots theo tài liệu có sẵn. Việc thiết lập khá đơn giản với developer quen với Go và Docker, tuy nhiên bộ tính năng MCP tổng thể còn hạn chế.

Điểm MCP

Ý kiến của chúng tôi:
Với bộ tính năng MCP hạn chế (không có prompt/resource, không hỗ trợ sampling/roots rõ ràng, và không có license), nhưng có một công cụ hoạt động và hướng dẫn thiết lập rõ ràng, MCP này đạt 3/10 về mức độ triển khai protocol và sẵn sàng hệ sinh thái.