Delorenj MCP Server Ticketmaster

🚀 TicketmasterのMCPサーバー

TicketmasterのMCPサーバーは、Ticketmaster 発見 API を通じて、イベント、会場、アトラクションを発見するためのツールを提供するモデルコンテキストプロトコルサーバーです。

🚀 クイックスタート

このサーバーを使用することで、イベント、会場、アトラクションを柔軟に検索できます。必要な情報をフィルタリングし、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: イベントの分類（例: '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 check
   

貢献

このプロジェクトへの貢献を歓迎します！詳細は 貢献ガイド をご覧ください。

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。