关键词

演出信息场馆搜索景点查询票务数据事件发现

Ticketmaster MCP Server使用说明

项目简介

Ticketmaster MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，它集成 Ticketmaster Discovery API，为 LLM 客户端提供查询演出、场馆和景点信息的功能。通过 'search_ticketmaster' 工具，LLM 可以根据关键词、日期、地点等条件搜索 Ticketmaster 数据库，获取结构化的 JSON 或易读的文本结果。

主要功能点

  • 演出、场馆和景点搜索: 提供单一工具 'search_ticketmaster'，支持根据多种参数（关键词、日期范围、城市、场馆ID、分类等）搜索演出、场馆和景点信息。
  • 灵活的输出格式: 支持 JSON 结构化数据和人类可读的文本格式输出，满足不同应用场景的需求。
  • 详细信息: 返回结果包含名称、ID、日期时间（演出）、价格范围（演出）、URL、图片、地点地址（场馆）、分类（景点）等详细信息。

安装步骤

  1. 使用 npm 全局安装 '@delorenj/mcp-server-ticketmaster' 包： 
    npx -y install @delorenj/mcp-server-ticketmaster

服务器配置

要将 Ticketmaster MCP Server 集成到 MCP 客户端，您需要在客户端的 MCP 服务器配置文件中添加以下配置信息。请务必将 'YOUR_TICKETMASTER_API_KEY' 替换为您在 Ticketmaster 开发者平台申请的 API 密钥。

{
  "mcpServers": {
    "ticketmaster": {
      "command": "npx",
      "args": ["-y", "@delorenj/mcp-server-ticketmaster"],
      "env": {
        "TICKETMASTER_API_KEY": "YOUR_TICKETMASTER_API_KEY"  // 替换为您的 Ticketmaster API 密钥
      }
    }
  }
}

配置参数说明:

  • 'server name': 'ticketmaster' (服务器名称，客户端通过此名称调用)
  • 'command': 'npx' (启动命令，使用 npx 运行 npm 包)
  • 'args': '["-y", "@delorenj/mcp-server-ticketmaster"]' (命令参数，指定要运行的 npm 包名)
  • 'env': 环境变量配置
    • 'TICKETMASTER_API_KEY': Ticketmaster API 密钥，必填，请替换为您的 API 密钥

基本使用方法

在 LLM 客户端中，您可以使用 '<use_mcp_tool>' 标签调用 'ticketmaster' 服务器的 'search_ticketmaster' 工具。以下是一些使用示例：

示例 1: 搜索纽约的演唱会 (JSON 输出)

<use_mcp_tool>
  <server_name>ticketmaster</server_name>
  <tool_name>search_ticketmaster</tool_name>
  <arguments>
    {
      "type": "event",
      "keyword": "concert",
      "city": "New York",
      "stateCode": "NY"
    }
  </arguments>
</use_mcp_tool>

示例 2: 搜索洛杉矶的体育场馆 (文本输出)

<use_mcp_tool>
  <server_name>ticketmaster</server_name>
  <tool_name>search_ticketmaster</tool_name>
  <arguments>
    {
      "type": "venue",
      "keyword": "stadium",
      "city": "Los Angeles",
      "stateCode": "CA",
      "format": "text"
    }
  </arguments>
</use_mcp_tool>

示例 3: 搜索音乐类的景点 (JSON 输出)

<use_mcp_tool>
  <server_name>ticketmaster</server_name>
  <tool_name>search_ticketmaster</tool_name>
  <arguments>
    {
      "type": "attraction",
      "classificationName": "Music"
    }
  </arguments>
</use_mcp_tool>

请根据 'search_ticketmaster' 工具的参数定义，灵活组合参数以实现更精确的搜索。详细参数说明请参考仓库 README 或工具的 'inputSchema' 定义。

信息

分类

网页与API

访问项目