Seatgeek MCP

🚀 seatgeek - mcp

SeatGeekのイベント、アーティスト、会場、セクション情報、推薦情報などのツールのレジストリを公開する包括的なMCPサーバーで、TypeScriptライブラリとして提供されます。

🚀 クイックスタート

デモ


前提条件

• Node.js >= 18.0.0
• npm >= 8.0.0

インストール

npm install seatgeek-mcp

使用方法

スタンドアロンサーバーとして

# STDIOトランスポート（デフォルト）
npm start

# HTTPストリーミングトランスポート
MCP_HTTP=1 PORT=8080 npm start

✨ 主な機能

ツール

• find_events：アーティスト、場所、日付、または会場でイベントを検索します。このツールは、ユーザーのクエリに基づいて特定のイベントを見つけるために最適化されています。クエリにアーティストが含まれている場合、まずアーティストを検索し、そのアーティストのイベントを見つけます。それ以外の場合は、直接イベントを検索します。会場情報を含む構造化されたイベントデータを返します。
• find_event_recommendations：アーティスト、イベント、または場所に基づいて、パーソナライズされたイベント推薦を取得します。このツールは、まずクエリに基づいてアーティストおよび/またはイベントを検索し、そのIDを使用して類似したイベントを見つけます。近くのイベントを取得するには、場所パラメータを使用します。
• find_performer_recommendations：アーティスト、イベント、または場所に基づいて、パーソナライズされたアーティスト推薦を取得します。このツールは、まずクエリに基づいてアーティストおよび/またはイベントを検索し、そのIDを使用して類似したアーティストを見つけます。
• retrieve_event_venue_information：特定のイベントのセクションや列を含む詳細な座席情報を取得します。このツールは、まず提供されたクエリを使用してイベントを検索し、次に詳細な会場レイアウト情報を取得します。

環境変数

• SEATGEEK_CLIENT_ID：あなたのSeatGeek APIクライアントID（必須）
• SEATGEEK_SECRET：あなたのSeatGeek APIシークレット（オプション）
• MCP_HTTP：任意の値に設定すると、STDIOの代わりにHTTPトランスポートが有効になります
• PORT：HTTPトランスポートを使用する場合のリッスンポート（デフォルト: 8080）

環境変数の設定

このMCPサーバーを使用するには、ルートディレクトリに.envファイルを作成し、SeatGeek APIの認証情報を設定する必要があります。

1. .env.exampleファイルを.envにコピーします。

   cp .env.example .env
   

2. .envファイルを編集し、プレースホルダー値を実際のSeatGeek APIの認証情報に置き換えます。

SeatGeek APIの認証情報は、SeatGeek Platformでアカウントを作成することで取得できます。

🔧 技術詳細

開発環境のセットアップ

npm install

ビルド

npm run build

開発サーバーの起動

npm run dev

ビルドのクリーンアップ

npm run clean

サーバーのテスト

サーバーをいくつかの方法でテストすることができます。

1. HTTPトランスポートを使用する（テストに最適）

   MCP_HTTP=1 PORT=8080 npm start
   

2. curlを使用してツールをテストする（適切なMCPプロトコルシーケンス）

   MCPプロトコルでは、適切なヘッダーを持つ特定のリクエストシーケンスが必要です。

   a. 接続の初期化（最初の必須ステップ）

   curl -v -X POST http://localhost:8080 \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event - stream" \
     -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-06-11", "capabilities": {}, "clientInfo": {"name": "curl", "version": "1.0.0"}}}'
   

   b. レスポンスヘッダーからセッションIDを抽出する（mcp - session - idを探します）

   c. 以降のリクエストにセッションIDを使用する

   # 利用可能なツールのリストを表示する
   curl -X POST http://localhost:8080 \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event - stream" \
     -H "Mcp - Session - Id: YOUR_SESSION_ID_HERE" \
     -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'
   
   # 特定のツールを呼び出す（例）
   curl -X POST http://localhost:8080 \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event - stream" \
     -H "Mcp - Session - Id: YOUR_SESSION_ID_HERE" \
     -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "find_events", "arguments": {"q": "concert", "per_page": 5}}}'
   

   完全な動作例については、以下を参照してください。

• [examples/curl - example.sh](examples/curl - example.sh) - リクエストの完全なシーケンスを示すシェルスクリプト
• [examples/node - example.js](examples/node - example.js) - プログラムによる使用方法を示すNode.jsスクリプト

3. テストスクリプトを使用する

   # シンプルなテストサーバースクリプトを実行する
   npm run test - server
   
   # 包括的なツールテストを実行する（サーバーを別途起動する必要があります）
   npm run test - tools
   

このサーバーは、Model Context Protocol (MCP)仕様を実装しているため、MCP互換のクライアントで使用することができます。

📚 ドキュメント

Claude Desktopでの使用方法

前提条件

• Claude Desktopがインストールされている
• 設定 -> 開発者の下にclaude_desktop_config.jsonが追加されている

セットアップ手順

• mcpServersリストに追加します。

"seatgeek-mcp": {
   "command": "node",
   "args": ["/path-to/seatgeek-mcp/dist/server.js"],
   "env": {
      "SEATGEEK_CLIENT_ID": "your-client-id"
   }
}

OpenWebUIでの使用方法

このMCPサーバーは、mcpo (MCP Over HTTP)プロキシを介してOpenWebUIで使用できます。このプロキシは、MCPツールのスキーマから自動的にOpenAPIドキュメントを生成します。

前提条件

• システムにDockerがインストールされている（uvを使用する場合はオプション）
• OpenWebUIがインストールされ、実行されている

セットアップ手順

1. mcpoプロキシを起動する

   docker run -p 8000:8000 -v $(pwd):/workspace -w /workspace ghcr.io/open - webui/mcpo:main -- npm start
   

   または

   uvx mcpo --port 8000 -- npm start
   

2. プロキシが実行されていることを確認する

   • ブラウザを開き、http://localhost:8000/docsにアクセスして、自動生成されたSwagger UIドキュメントを表示します。
   • http://localhost:8000/openapi.jsonでOpenAPI仕様を確認することもできます。

3. OpenWebUIに接続する

   • OpenWebUIを開きます。
   • 設定 > ツールと統合に移動します。
   • 新しいOpenAPI互換ツールを追加します。
   • URLとしてhttp://localhost:8000を使用します。

OpenWebUIでの使用例

接続後、OpenWebUIでこれらのツールを使用して、以下のようなリクエストを行うことができます。

• アーティストを検索する: {"q": "washington nationals", "per_page": 5}
• 会場を検索する: {"city": "New York", "per_page": 5}

mcpoプロキシは、OpenAPI RESTインターフェースとMCPプロトコルの間の変換を自動的に処理するため、OpenWebUIが簡単に統合できる標準的なRESTエンドポイントを介してMCPツールにアクセスできます。