Gigapipe MCP

🚀 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 許可證。