MCP Server for Ticketmaster

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

<a href="https://glama.ai/mcp/servers/u91gv8f3on"><img width="380" height="200" src="https://gips1.baidu.com/it/u=3056058322,485785872&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Ticketmaster Events MCP服务器" /></a>

特性

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

安装

通过Smithery安装

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

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. 在你的账户中前往“我的应用”
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": "音乐会",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "纽约",
  "stateCode": "NY"
}
</arguments>
</use_mcp_tool>

人类可读文本输出

<use_mcp_tool>
<server_name>ticketmaster</server_name>
<tool_name>search_ticketmaster</tool_name>
<arguments>
{
  "type": "event",
  "keyword": "音乐会",
  "startDate": "2025-02-01",
  "endDate": "2025-02-28",
  "city": "纽约",
  "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文件