票务发现服务

一个通过Ticketmaster Discovery API提供活动、场馆和景点搜索工具的模型上下文协议服务器。

  • by delorenj
  • TypeScript
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 delorenj/mcp-server-ticketmaster

使用说明

Ticketmaster的MCP服务器

模型上下文协议服务器,提供通过Ticketmaster Discovery API发现事件、场所和景点的工具。

特性

  • 使用灵活的过滤功能搜索活动、场地和景点:
    • 关键字搜索
    • 事件的日期范围
    • 地点(城市、州、国家)
    • 特定场地搜索
    • 特定景点搜索
    • 事件分类/类别
  • 输出格式:
    • 用于编程的结构化JSON数据
    • 供直接使用的人类可读文本
  • 综合数据包括:
    • 姓名和ID
    • 日期和时间(活动)
    • 价格范围(活动)
    • 网址
    • 图像
    • 地点和地址(场馆)
    • 分类(景点)

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的mcp服务器ticketmaster 史密瑟里:

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:搜索类型(“事件”、“地点”或“景点”)

可选参数

  • keyword:搜索词
  • startDate:YYYY-MM-DD格式的开始日期(用于事件)
  • endDate:YYYY-MM-DD格式的结束日期(用于事件)
  • city:城市名称
  • stateCode:州代码(例如“NY”)
  • countryCode:国家代码(例如“美国”)
  • 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",
  "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>

发展

  1. 克隆存储库
  2. 复制示例环境文件:
    cp .env.example .env
    
  3. 将Ticketmaster API密钥添加到 .env
  4. 安装依赖项:
    npm install
    
  5. 构建项目:
    npm run build
    
  6. 与检验员一起测试:
    npm run inspector
    

贡献

欢迎投稿!请随时提交拉取请求。对于重大更改,请先打开一个问题来讨论您想要更改的内容。

许可证

MIT许可证-请参阅 许可证 详细信息文件