Tempo MCP Server
2025.04.12
0
Go追踪数据分析AI工具集成开发效率
Tempo MCP Server 是一个基于 Go 语言实现的 Model Context Protocol (MCP) 服务器，集成了 Grafana Tempo 分布式追踪系统。它允许 AI 助手查询和分析来自 Grafana Tempo 的追踪数据，为兼容的 AI 客户端（如 Claude Desktop）提供工具定义。
View on GitHub
Overview
基本能力
产品定位
Tempo MCP Server 是一个为 AI 助手提供 Grafana Tempo 追踪数据查询和分析能力的 MCP 服务器。
核心功能
- 实现 Model Context Protocol (MCP) 标准
- 提供 Tempo 查询工具 (
tempo_query) - 支持通过环境变量配置默认 Tempo 服务器 URL
- 支持多种认证方式（基本认证、Bearer token）
- 提供 Docker 和 Docker Compose 支持
- 可与 Claude Desktop 和 Cursor 编辑器集成
适用场景
- AI 助手查询分布式追踪数据
- 开发人员通过 AI 工具分析服务性能问题
- 集成到开发环境中提供追踪数据查询能力
工具列表
tempo_query工具：- 查询 Grafana Tempo 追踪数据
- 支持多种查询参数和认证方式
- 可通过环境变量配置默认 Tempo 服务器 URL
常见问题解答
- 如何配置默认 Tempo 服务器 URL？
- 通过设置
TEMPO_URL环境变量 - 如何与 Claude Desktop 集成？
- 修改 Claude Desktop 配置文件，添加 MCP 服务器配置
- 如何与 Cursor 编辑器集成？
- 修改 Cursor 设置，添加 MCP 服务器配置
使用教程
使用依赖
- Go 1.21 或更高版本
- Docker 和 Docker Compose（用于本地测试）
安装教程
- 使用 Go 构建和运行： ```bash # 构建服务器 go build -o tempo-mcp-server ./cmd/server
# 运行服务器
./tempo-mcp-server
或直接运行：bash
go run ./cmd/server
```
- 使用 Docker 构建和运行： ```bash # 构建 Docker 镜像 docker build -t tempo-mcp-server .
# 运行服务器 docker run --rm -i tempo-mcp-server ```
- 使用 Docker Compose 运行完整测试环境：
bash docker-compose up --build
调试方式
- 测试查询：
bash ./run-client.sh tempo_query "{resource.service.name=\\\"example-service\\\"}" - 与 Claude Desktop 集成测试：
- 配置 Claude Desktop 后，尝试查询如：
"Query Tempo for traces with the query
{duration>1s}" "Find traces from the frontend service in Tempo using query{service.name=\"frontend\"}"