Theme Parks

主题公园的MCP服务器.wiki(mcp-server-theme-parks)

该项目提供了一个模型上下文协议（MCP）服务器，该服务器与 主题公园.wikineneneba API。它允许用户访问主题公园的实时和静态数据，包括目的地、景点、等待时间和时间表。

Avatar

先决条件

• Node.js>=18

设置和安装

1. 克隆存储库（如果适用）：

   git clone https://github.com/MasonMao-dev/mcp-server-theme-parks.git
   cd mcp-server-theme-parks

1. 安装依赖项：

   npm install

运行服务器

MCP服务器配置（适用于MCP客户端）

要将此服务器与MCP兼容的客户端一起使用，您通常会按如下方式配置客户端：

{
  "mcpServers": {
    "mcp-server-theme-parks": {
      "command": "npx",
      "args": ["-y", "mcp-server-theme-parks"],
      "env": {
        "THEMEPARKS_API_BASE_URL": "https://api.themeparks.wiki/v1"
      }
    }
  }
}

如果从源代码本地运行（之后 npm install 和 npm run build):

{
  "mcpServers": {
    "mcp-server-theme-parks": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/your/cloned/mcp-server-theme-parks", // Update this path
      "env": {
        "THEMEPARKS_API_BASE_URL": "https://api.themeparks.wiki/v1"
      }
    }
  }
}

使用MCP检查器进行调试

您可以使用MCP检查器调试服务器：

npx @modelcontextprotocol/inspector -e THEMEPARKS_API_BASE_URL=https://api.themeparks.wiki/v1 node dist/index.js

确保您首先构建了项目(npm run build).

可用工具

服务器公开了以下可由MCP客户端调用的工具：

1. list_destinations

- 说明： 检索所有可用顶级主题公园目的地的列表（例如，华特迪士尼世界度假区、奥兰多环球影城度假区）。 - 参数： 无

1. get_entity_details

- 说明： 使用特定实体（如公园、景点或餐厅）的唯一ID获取其详细的静态信息。 - 参数： - entity_id （字符串，UUID，必填）：实体的唯一GUID标识符。

1. get_entity_children

- 说明： 检索给定父实体ID的所有直接子实体（例如，目的地内的所有公园或公园内的所有景点）。 - 参数： - entity_id （字符串，UUID，必填）：父实体的唯一GUID标识符。

1. get_entity_live_data

- 说明： 获取特定实体及其子实体的实时数据。这可能包括景点等待时间、公园运营时间和表演时间。 - 参数： - entity_id （字符串，UUID，必填）：实体的唯一GUID标识符。

1. get_entity_schedule

- 说明： 检索特定实体的操作计划或日历数据。可以指定年和月，或获取常规日程数据。 - 参数： - entity_id （字符串，UUID，必填）：实体的唯一GUID标识符。 - year （整数，可选）：日程表的年份（例如2025年）。如果省略月份，则取总计划。 - month （整数，可选）：日程表的月份（1-12）。如果省略年份，则取总进度表。需要 year 如果指定。（如果有，必须提供年份和月份。）

帮助提示

服务器还提供 help 提示：

• help

- 说明： 提供所有可用工具及其用法的摘要。 - 参数： 无 - 输出： 一条用户友好的消息，列出了所有工具、它们的描述和参数。