<a href="https://gigapipe.com" target="_blank"> <img src='https://gips1.baidu.com/it/u=1435392991,162061752&fm=3081&app=3081&f=GIF?w=480&h=494' style="margin-left:-10px;width:200px;" height=200 > </a>

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 GGAPIPE_USERNAME="your-username"
export GIGAPIPE_PASSWORD="your-password"

注意：如果在 GIGAPIPE_HOST 中未指定协议，默认使用 http://。

使用

Prometheus 工具

1. 查询指标

# 使用 PromQL 查询指标
prometheus_query --query="rate(http_requests_total[5m])" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --step="1m"

2. 列出标签

# 列出所有可用标签
prometheus_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

3. 获取标签值

# 获取特定标签的值
prometheus_label_values --label="instance" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

Loki 工具

1. 查询日志

# 使用 LogQL 查询日志
loki_query --query='{job="varlogs"}' --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --limit="100"

2. 列出标签

# 列出所有可用标签
loki_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

3. 获取标签值

# 获取特定标签的值
loki_label_values --label="job" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

Tempo 工具

1. 查询追踪

# 根据追踪ID查询追踪
tempo_query --trace_id="1234567890abcdef"

2. 列出标签

# 列出所有可用追踪标签
tempo_tags

3. 获取标签值

# 获取特定追踪标签的值
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 许可证