MCP Server for Ticketmaster

Ticketmaster 向け MCP サーバー

Ticketmaster Discovery API を通じて、イベント、会場、アトラクションを検索するツールを提供する Model Context Protocol サーバーです。

機能

• 柔軟なフィルターを使ってイベント、会場、アトラクションを検索できます：
  • キーワード検索
  • イベントの日付範囲
  • 場所（市区町村、州、国）
  • 会場に絞った検索
  • アトラクションに絞った検索
  • イベントの分類／カテゴリー
• 出力形式：
  • プログラムから利用できる構造化 JSON データ
  • そのまま利用できる人が読みやすいテキスト
• 次の情報を含む包括的なデータ：
  • 名前と ID
  • 日付と時刻（イベントの場合）
  • 価格帯（イベントの場合）
  • URL
  • 画像
  • 場所と住所（会場の場合）
  • 分類（アトラクションの場合）

インストール

Smithery 経由でインストールする

Smithery 経由で mcp-server-ticketmaster を Claude Desktop に自動でインストールするには：

npx -y @smithery/cli install mcp-server-ticketmaster --client claude

手動でインストールする

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

設定

このサーバーには Ticketmaster API キーが必要です。次の手順で取得できます：

1. https://developer.ticketmaster.com/ にアクセスします
2. アカウントを作成するか、サインインします
3. アカウントの「My Apps」に移動します
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：イベントカテゴリー（例：'Sports'、'Music'）
• 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",
  "stateCode": "NY"
}
</arguments>
</use_mcp_tool>

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

<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",
  "stateCode": "NY",
  "format": "text"
}
</arguments>
</use_mcp_tool>

開発

1. リポジトリをクローンします
2. 環境設定ファイルの例をコピーします：

   cp .env.example .env
   

3. .env に Ticketmaster API キーを追加します
4. 依存関係をインストールします：

   npm install
   

5. プロジェクトをビルドします：

   npm run build
   

6. インスペクターでテストします：

   npm run inspector
   

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更の場合は、まず issue を作成して、変更内容についてご相談ください。

ライセンス

MIT License — 詳細は LICENSE ファイルをご覧ください