JinDaGe - delorenj_mcp-server-ticketmaster MCP Details

article

README

🚀 Ticketmaster 的 MCP 服务器

这是一个基于 Ticketmaster 发现 API 构建的模型上下文协议服务器，为用户提供了强大的活动、场馆和景点发现工具，助力用户高效精准地获取所需信息。

🚀 快速开始

本服务器借助 Ticketmaster 发现 API 实现，能为您提供活动、场馆和景点的搜索功能。您只需按照以下步骤操作，即可快速上手使用。

✨ 主要特性

灵活的搜索过滤选项：在搜索事件、场馆和景点时，支持多种过滤方式，包括关键字搜索、指定事件日期范围、根据地理位置（城市、州、国家）筛选、特定场馆或景点搜索以及按事件分类/类别查找。
多样化的输出格式：支持以结构化 JSON 数据输出，方便程序设计使用；也能以可读文本形式呈现，便于直接查看。
全面的数据信息：搜索结果包含丰富的数据，如名称和 ID、活动的日期和时间、活动的价格范围、URL、场馆的地点和地址以及景点的分类等。

📦 安装指南

使用以下命令进行安装：

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

🛠️ 配置说明

该服务器需要 Ticketmaster API 密钥，您可按以下步骤获取：

访问 Ticketmaster 开发者官网。
创建账户或登录已有账户。
在账户中进入“我的应用”页面。
创建新应用以获取 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'。

👨‍💻 开发指南

若您想参与项目开发，可按以下步骤操作：

克隆仓库。
复制示例环境文件：
```
cp .env.example .env
```
将 Ticketmaster API 密钥添加到 .env 文件。
安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```
使用检查器测试：
```
npm run check
```

🤝 贡献说明

欢迎为这个项目贡献力量！请查看贡献指南了解详细信息。

📄 许可证

该项目遵循 MIT License。

delorenj_mcp-server-ticketmaster