🚀 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。