MCP Server for Ticketmaster

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

功能

• 通过灵活的过滤器搜索活动、场地和景点：
  • 关键词搜索
  • 活动日期范围
  • 位置（城市、州/省、国家）
  • 特定场地搜索
  • 特定景点搜索
  • 活动分类/类别
• 输出格式：
  • 用于编程使用的结构化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。对于重大更改，请先打开一个问题来讨论你想要进行的更改。

许可证

MIT许可证 - 详情见LICENSE文件