JinDaGe - mcp-server-ticketmaster MCP Details

article

README

🚀 MCP 服务器用于票务大师（Ticketmaster）

本 MCP 服务器专为票务大师（Ticketmaster）设计，能帮助用户灵活搜索事件、场地和景点信息，提供结构化 JSON 数据和人类可读文本两种输出格式，为票务信息的获取和使用带来便利。

🚀 快速开始

使用此 MCP 服务器，你可以轻松搜索票务大师（Ticketmaster）上的各类票务信息。先完成安装和配置，然后就能使用提供的工具进行搜索。

✨ 主要特性

搜索功能灵活：支持对事件、场地和景点进行搜索，并提供多种过滤选项，具体如下：
- 关键词搜索：通过输入关键词精准定位所需信息。
- 事件时间范围：可根据开始和结束日期筛选特定时间段内的事件。
- 位置筛选：支持按城市、州、国家等位置信息进行搜索。
- 场地特定搜索：针对特定场地进行搜索。
- 景点特定搜索：精准查找特定景点的相关信息。
- 事件分类/类别：按照不同的事件类别进行搜索。
多样输出格式：
- 结构化的 JSON 数据：适合程序使用，方便进行数据处理和集成。
- 人类可读文本：便于直接阅读，快速获取信息。
全面数据内容：搜索结果包含丰富的数据，涵盖名称和 ID、日期和时间（针对事件）、价格范围（针对活动）、URL 地址、地点和地址（针对场地）、分类（针对景点）等。

📦 安装指南

使用以下命令安装 MCP 服务器：

npx -y install @delorenj/mcp-server-ticketmaster

📚 详细文档

配置说明

服务器需要一个票务大师（Ticketmaster）API 密钥，你可以按以下步骤获取：

访问票务大师开发者官网。
创建账户或登录已有账户。
进入账户中的“我的应用”。
创建一个新的应用程序以获取 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：事件类别，例如 '体育'、'音乐'。
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"
}
</arguments>
</use_mcp_tool>

人类可读文本输出

搜索结果：
- 事件名称：音乐会门票
- 时间：2025年2月1日
- 地点：纽约市

开发说明

克隆仓库

使用以下命令克隆项目仓库：

git clone [仓库地址]
cd mcp-server-ticketmaster

复制环境文件

复制并修改 env.example 文件为 .env，添加 API 密钥和相关配置。

安装依赖

安装所有项目依赖：

npm install

构建项目

构建项目以生成生产文件：

npm run build

贡献说明

欢迎提交 Pull Request！在进行重大更改之前，请先进行讨论，以便更好地协作。

📄 许可证

请参考 LICENSE 文件获取详细许可信息。

mcp-server-ticketmaster