🚀 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>ticketmasterserver_name>
<tool_name>search_ticketmastertool_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>ticketmasterserver_name>
<tool_name>search_ticketmastertool_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。