Gigapipe MCP

🚀 Gigapipe MCP Server

Gigapipe用のMachine Control Protocol (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ツール

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"

🔧 技術詳細

サーバーは以下のエンドポイントを使用して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ライセンス