Delorenj MCP Server Ticketmaster

🚀 Ticketmaster 的 MCP 服務器

這是一個基於 Ticketmaster 發現 API 構建的模型上下文協議服務器，為用戶提供了強大的活動、場館和景點發現工具，助力用戶高效精準地獲取所需信息。

🚀 快速開始

本服務器藉助 Ticketmaster 發現 API 實現，能為您提供活動、場館和景點的搜索功能。您只需按照以下步驟操作，即可快速上手使用。

✨ 主要特性

• 靈活的搜索過濾選項：在搜索事件、場館和景點時，支持多種過濾方式，包括關鍵字搜索、指定事件日期範圍、根據地理位置（城市、州、國家）篩選、特定場館或景點搜索以及按事件分類/類別查找。
• 多樣化的輸出格式：支持以結構化 JSON 數據輸出，方便程序設計使用；也能以可讀文本形式呈現，便於直接查看。
• 全面的數據信息：搜索結果包含豐富的數據，如名稱和 ID、活動的日期和時間、活動的價格範圍、URL、場館的地點和地址以及景點的分類等。

📦 安裝指南

使用以下命令進行安裝：

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

🛠️ 配置說明

該服務器需要 Ticketmaster API 密鑰，您可按以下步驟獲取：

1. 訪問 Ticketmaster 開發者官網。
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 工具，以下是使用示例：

結構化 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>

參數說明

必要參數

• 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'。

👨‍💻 開發指南

若您想參與項目開發，可按以下步驟操作：

1. 克隆倉庫。
2. 複製示例環境文件：

   cp .env.example .env
   

3. 將 Ticketmaster API 密鑰添加到 .env 文件。
4. 安裝依賴項：

   npm install
   

5. 構建項目：

   npm run build
   

6. 使用檢查器測試：

   npm run check
   

🤝 貢獻說明

歡迎為這個項目貢獻力量！請查看 貢獻指南 瞭解詳細信息。

📄 許可證

該項目遵循 MIT License。