MCP Server for Ticketmaster

Ticketmaster 的 MCP 服务

一个 Model Context Protocol 服务，提供通过 Ticketmaster Discovery API 发现活动、场馆和景点的工具。

功能

• 通过灵活的筛选条件搜索活动、场馆和景点：
  • 关键词搜索
  • 活动的日期范围
  • 位置（城市、州、国家）
  • 特定场馆搜索
  • 特定景点搜索
  • 活动分类/类别
• 输出格式：
  • 用于程序化使用的结构化 JSON 数据
  • 用于直接阅读的人类可读文本
• 全面的数据，包括：
  • 名称和 ID
  • 日期和时间（针对活动）
  • 价格范围（针对活动）
  • URL
  • 图片
  • 位置和地址（针对场馆）
  • 分类（针对景点）

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 mcp-server-ticketmaster：

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

   npm install
   

5. 构建项目：

   npm run build
   

6. 使用检查器测试：

   npm run inspector
   

贡献

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

许可证

MIT License - 详见 LICENSE 文件