Ticketmaster 的 MCP 服务器

一个模型上下文协议服务器，提供通过 Ticketmaster Discovery API 发现活动、场馆和景点的工具。

功能

• 搜索活动、场馆和景点，具有灵活的过滤功能：
  • 关键词搜索
  • 活动的日期范围
  • 地点（城市、州、国家）
  • 场馆特定搜索
  • 景点特定搜索
  • 活动分类/类别
• 输出格式：
  • 用于编程的结构化 JSON 数据
  • 用于直接消费的人类可读文本
• 综合数据包括：
  • 名称和 ID
  • 日期和时间（对于活动）
  • 价格范围（对于活动）
  • URL
  • 图片
  • 地点和地址（对于场馆）
  • 分类（对于景点）

安装

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. 将您的 Ticketmaster API 密钥添加到 .env
4. 安装依赖项：

   npm install
   

5. 构建项目：

   npm run build
   

6. 使用检查器进行测试：

   npm run inspector
   

贡献

欢迎贡献！ 请随时提交 Pull Request。 对于重大更改，请先打开一个 issue 讨论您想要更改的内容。

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件