🚀 Gigapipe MCP 服务器
Gigapipe 的机器控制协议（MCP）服务器，提供统一接口来查询 Prometheus 指标、Loki 日志和 Tempo 追踪数据。
✨ 主要特性
Prometheus 集成
- 使用 PromQL 查询指标
- 列出所有可用标签
- 获取特定标签的值
- 支持时间范围查询
Loki 集成
- 使用 LogQL 查询日志
- 列出所有可用标签
- 获取特定标签的值
- 支持时间范围查询
Tempo 集成
- 按追踪 ID 查询追踪数据
- 列出所有可用的追踪标签
- 获取特定追踪标签的值
- 支持 JSON 追踪格式
📦 安装指南
# 克隆仓库
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp
# 构建服务器
go build -o gigapipe-mcp
📚 详细文档
配置
服务器可以使用环境变量进行配置：
# 必需：Gigapipe 服务器地址（默认：http://localhost:3100）
# 必须包含协议（http:// 或 https://）
export GIGAPIPE_HOST="https://your-host:3100"
# 可选：HTTP 基本认证
export GIGAPIPE_USERNAME="your-username"
export GIGAPIPE_PASSWORD="your-password"
注意：如果 GIGAPIPE_HOST 中未指定协议，将默认使用 http://。
使用方法
Prometheus 工具
- 查询指标
# 使用 PromQL 查询指标
prometheus_query --query="rate(http_requests_total[5m])" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --step="1m"
- 列出标签
# 列出所有可用标签
prometheus_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
- 获取标签值
# 获取特定标签的值
prometheus_label_values --label="instance" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
Loki 工具
- 查询日志
# 使用 LogQL 查询日志
loki_query --query='{job="varlogs"}' --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --limit="100"
- 列出标签
# 列出所有可用标签
loki_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
- 获取标签值
# 获取特定标签的值
loki_label_values --label="job" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
Tempo 工具
- 查询追踪数据
# 按 ID 查询追踪数据
tempo_query --trace_id="1234567890abcdef"
- 列出标签
# 列出所有可用的追踪标签
tempo_tags
- 获取标签值
# 获取特定追踪标签的值
tempo_tag_values --tag="service.name"
API 端点
服务器通过以下端点与 Gigapipe 进行通信：
Prometheus
- 范围查询：
/api/v1/query_range - 查询：
/api/v1/query - 标签：
/api/v1/labels - 标签值：
/api/v1/label/:name/values
Loki
- 范围查询：
/loki/api/v1/query_range - 查询：
/loki/api/v1/query - 标签：
/loki/api/v1/label - 标签值：
/loki/api/v1/label/:name/values
Tempo
- 查询追踪数据：
/api/traces/:traceId - 查询追踪数据（JSON）：
/api/traces/:traceId/json - 标签：
/api/search/tags - 标签值：
/api/search/tag/{name}/values
开发
前提条件
- Go 1.16 或更高版本
- Git
从源代码构建
# 克隆仓库
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp
# 安装依赖
go mod download
# 构建服务器
go build -o gigapipe-mcp
# 运行测试
go test ./...
📄 许可证
本项目采用 MIT 许可证。