Tempo MCP Server

🚀 Tempo MCP サーバー

Go 言語で実装されたサーバーで、Model Context Protocol（MCP）を介して Grafana Tempo との統合を実現します。このサーバーにより、AI アシスタントが Grafana Tempo の分散トレースデータを照会および分析できるようになります。

🚀 クイックスタート

前提条件

• Go 1.21 以上
• Docker と Docker Compose（ローカルテスト用）

ビルドと実行

サーバーをビルドして実行するには、以下のコマンドを使用します。

# プロジェクトをビルド
go build

# サーバーを実行
./tempo-mcp-server

✨ 主要特性

この MCP サーバーは、Model Context Protocol（MCP）に準拠しており、Claude Desktop などの互換性のある AI クライアントと連携できます。AI アシスタントが Grafana Tempo の分散トレースデータを照会および分析することを可能にします。

📦 インストール

Docker を使用したインストール

以下のコマンドを使用して、プロジェクトを Docker イメージとしてビルドして実行できます。

# Docker イメージをビルド
docker build -t tempo-mcp-server .

# Docker コンテナを実行
docker run -p 8080:8080 tempo-mcp-server

💻 使用例

基本的な使用法

サーバーを構築して実行するには、以下のコマンドを使用します。

# プロジェクトをビルド
go build

# サーバーを実行
./tempo-mcp-server

高度な使用法

Docker を使用してサーバーを実行するには、以下のコマンドを使用します。

# Docker イメージをビルド
docker build -t tempo-mcp-server .

# Docker コンテナを実行
docker run -p 8080:8080 tempo-mcp-server

📚 ドキュメント

サーバーエンドポイント

• HTTP エンドポイント：http://localhost:8080
• WebSocket エンドポイント：ws://localhost:8080/ws

プロジェクト構造

以下は、プロジェクトのディレクトリ構造です。

tempo-mcp-server/
├── main.go                 # メインプログラムのエントリーポイント
├── server.go               # サーバーの実装
├── handler.go              # リクエスト処理のロジック
└── docker/Dockerfile      # Docker の設定ファイル

MCP サーバー

ツール定義

以下は、MCP サーバーがサポートするツールとその詳細情報です。

tempo_query

• 説明：Grafana Tempo のトレースデータを照会するために使用します。
• 必須パラメータ：
  • query：実行する照会文。
• オプションパラメータ：
  • limit：返される結果の数を制限します（デフォルト値は 10）。

環境変数

以下の環境変数は、サーバーの動作に影響を与えます。

テスト

以下のコマンドを使用してテストを実行できます。

go test ./...

他のアプリケーションとの統合

Claude Desktop との統合

Tempo MCP サーバーを Claude Desktop と統合するには、以下の手順に従ってください。

1. Claude Desktop の設定ファイルを開きます。
2. mcpServers セクションに以下の内容を追加します。

{
  "tempo-mcp-server": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "-e", "TEMPO_URL=http://host.docker.internal:8080", "tempo-mcp-server:latest"]
  }
}

3. ファイルを保存し、Claude Desktop を再起動します。

Cursor との統合

Cursor で Tempo MCP サーバーを使用するには、以下の手順に従ってください。

1. Cursor の設定を開きます。
2. mcpServers セクションに以下の内容を追加します。

{
  "tempo-mcp-server": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "-e", "TEMPO_URL=http://host.docker.internal:8080", "tempo-mcp-server:latest"]
  }
}

3. 設定を保存します。

n8n との統合

Tempo MCP サーバーを n8n と統合するには、以下の手順に従ってください。

1. n8n で MCP クライアントツール ノードを追加します。
2. ノードを以下のように構成します。
   • SSE エンドポイント：http://your-server-address:8080/sse
   • 認証：適切な認証方法を選択します。
   • 含まれるツール：AI エージェントに公開するツールを選択します。
3. MCP クライアントツールノードを、Claude などのサポートされている AI エージェントノードに接続します。

サンプルクエリ

設定が完了したら、Claude で以下のクエリを使用できます。

• “{duration>1s} を使用して Tempo のトレースデータを照会する”
• “{service.name=\"frontend\"} クエリを使用して、Tempo のフロントエンドサービスのトレースレコードを検索する”
• “{http.status_code=500} を満たす最近の 50 件の Tempo トレースレコードを表示する”

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。