Gigapipe MCP服务器
Gigapipe的机器控制协议(MCP)服务器,提供了一个统一的接口来查询Prometheus指标、Loki日志和Tempo跟踪。
特性
普罗米修斯集成
- 使用PromQL查询指标
- 列出所有可用标签
- 获取特定标签的值
- 支持时间范围查询
洛基集成
- 使用LogQL查询日志
- 列出所有可用标签
- 获取特定标签的值
- 支持时间范围查询
Tempo集成
- 按跟踪ID查询跟踪
- 列出所有可用的跟踪标签
- 获取特定跟踪标记的值
- 支持JSON跟踪格式
安装```bash
Clone the repository
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp
Build the server
go build -o gigapipe-mcp
## 配置
可以使用环境变量配置服务器:```bash
# 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://作为默认协议。
用法
普罗米修斯工具
- 查询指标```bash
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"
2. 列表标签```bash
# List all available labels
prometheus_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
- 获取标签值```bash
Get values for a specific label
prometheus_label_values --label="instance" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
### 洛基工具
1. 查询日志```bash
# Query logs with LogQL
loki_query --query='{job="varlogs"}' --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --limit="100"
- 列表标签```bash
List all available labels
loki_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
3. 获取标签值```bash
# Get values for a specific label
loki_label_values --label="job" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"
Tempo工具
- 查询跟踪```bash
Query a trace by ID
tempo_query --trace_id="1234567890abcdef"
2. 列表标记```bash
# List all available trace tags
tempo_tags
- 获取标签值```bash
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
### 从源头构建```bash
# 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许可证
