Gigapipe MCP服务器
Gigapipe的机器控制协议（MCP）服务器，提供了一个统一的接口来查询Prometheus指标、Loki日志和Tempo跟踪。
特性
普罗米修斯集成
- 使用PromQL查询指标
- 列出所有可用标签
- 获取特定标签的值
- 支持时间范围查询
洛基集成
- 使用LogQL查询日志
- 列出所有可用标签
- 获取特定标签的值
- 支持时间范围查询
Tempo集成
- 按跟踪ID查询跟踪
- 列出所有可用的跟踪标签
- 获取特定跟踪标记的值
- 支持JSON跟踪格式
安装
# Clone the repository
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp
# Build the server
go build -o gigapipe-mcp配置
可以使用环境变量配置服务器：
# Required: Gigapipe server address (default: http://localhost:3100)
# Must include protocol (http:// or https://)
export GIGAPIPE_HOST="https://your-host:3100"
# Optional: HTTP Basic Authentication
export GIGAPIPE_USERNAME="your-username"
export GIGAPIPE_PASSWORD="your-password"注意：如果GIGAPPE_HOST中没有指定协议，则将使用http://作为默认协议。
用法
普罗米修斯工具
- 查询指标
# Query metrics with PromQL
prometheus_query --query="rate(http_requests_total[5m])" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --step="1m"- 列表标签
# List all available labels
prometheus_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"- 获取标签值
# Get values for a specific label
prometheus_label_values --label="instance" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"洛基工具
- 查询日志
# Query logs with LogQL
loki_query --query='{job="varlogs"}' --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --limit="100"- 列表标签
# List all available labels
loki_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"- 获取标签值
# Get values for a specific label
loki_label_values --label="job" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"Tempo工具
- 查询跟踪
# Query a trace by ID
tempo_query --trace_id="1234567890abcdef"- 列表标记
# List all available trace tags
tempo_tags- 获取标签值
# Get values for a specific trace tag
tempo_tag_values --tag="service.name"API终点
服务器使用以下端点与Gigapipe通信：
普罗米修斯
- 查询范围：
/api/v1/query_range - 查询：
/api/v1/query - 标签：
/api/v1/labels - 标签值：
/api/v1/label/:name/values
洛基
- 查询范围：
/loki/api/v1/query_range - 查询：
/loki/api/v1/query - 标签：
/loki/api/v1/label - 标签值：
/loki/api/v1/label/:name/values
节奏
- 查询跟踪：
/api/traces/:traceId - 查询跟踪（JSON）：
/api/traces/:traceId/json - 标签：
/api/search/tags - 标签值：
/api/search/tag/{name}/values
发展
先决条件
- 转到1.16或更高版本
- Git
从源头构建
# Clone the repository
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp
# Install dependencies
go mod download
# Build the server
go build -o gigapipe-mcp
# Run tests
go test ./...许可证
MIT许可证