MCP Server Ticketmaster

🚀 MCP サーバー（チケットマスター用）

この MCP サーバーは、チケットマスター（Ticketmaster）のイベント、会場、アトラクションに関する情報を検索するためのツールです。柔軟なフィルタリングオプションを備え、JSON データや人間が読みやすいテキスト形式で出力することができます。

✨ 主な機能

• イベント、会場、アトラクションの検索：柔軟なフィルタオプションを提供します。
  • キーワード検索
  • イベントの時間範囲
  • 位置（都市、州、国）
  • 会場特定の検索
  • アトラクション特定の検索
  • イベントの分類/カテゴリ
• 出力形式：
  • プログラムで使用するのに適した構造化 JSON データ
  • 直接読むのに適した人間が読みやすいテキスト
• 包括的なデータ：
  • 名前と ID
  • 日付と時間（イベントの場合）
  • 価格範囲（イベントの場合）
  • URL アドレス
  • 場所と住所（会場の場合）
  • 分類（アトラクションの場合）

📦 インストール

npx -y install @delorenj/mcp-server-ticketmaster

📚 ドキュメント

設定

サーバーにはチケットマスター（Ticketmaster）の API キーが必要です。以下の手順で取得できます。

1. https://developer.ticketmaster.com/ にアクセスします。
2. アカウントを作成するか、ログインします。
3. アカウント内の「マイアプリ」にアクセスします。
4. 新しいアプリケーションを作成して、API キーを取得します。

MCP 設定ファイルで API キーを設定します。

{
  "mcpServers": {
    "ticketmaster": {
      "command": "npx",
      "args": ["-y", "@delorenj/mcp-server-ticketmaster"],
      "env": {
        "TICKETMASTER_API_KEY": "your-api-key-here"
      }
    }
  }
}

使用方法

サーバーは search_ticketmaster というツールを提供しており、以下のパラメータを受け付けます。

必須パラメータ

• type: 検索タイプ（'event', 'venue', または 'attraction'）

オプションパラメータ

• keyword: 検索キーワード
• startDate: 開始日（形式：YYYY-MM-DD）（イベントの場合）
• endDate: 終了日（形式：YYYY-MM-DD）（イベントの場合）
• city: 都市名
• stateCode: 州コード（例：'NY'）
• countryCode: 国コード（例：'US'）
• venueId: 特定の会場 ID
• attractionId: 特定のアトラクション ID
• classificationName: イベントのカテゴリ（例：'体育', '音楽'）
• format: 出力形式（'json' または 'text'）、デフォルトは 'json'

例

構造化 JSON 出力（デフォルト）

<use_mcp_tool>
<server_name>ticketmaster</server_name>
<tool_name>search_ticketmaster</tool_name>
<arguments>
{
  "type": "event",
  "keyword": "concert",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "New York"
}
</arguments>
</use_mcp_tool>

人間が読みやすいテキスト出力

検索結果：
- イベント名：コンサートチケット
- 時間：2025年2月1日
- 場所：ニューヨーク市

開発

リポジトリのクローン

以下のコマンドでプロジェクトリポジトリをクローンします。

git clone [仓库地址]
cd mcp-server-ticketmaster

環境ファイルのコピー

env.example ファイルを .env にコピーし、API キーと関連する設定を追加します。

依存関係のインストール

すべてのプロジェクト依存関係をインストールします。

npm install

プロジェクトのビルド

プロジェクトをビルドして、本番用のファイルを生成します。

npm run build

🤝 貢献

Pull Request の送信を歓迎します！重大な変更を行う前に、コラボレーションを円滑に進めるために事前に議論してください。

📄 ライセンス

詳細なライセンス情報については、LICENSE ファイルを参照してください。