Mcp Server For Themeparks.wiki

ThemeParks.wiki MCP 服务（mcp-server-theme-parks）

本项目提供一个模型上下文协议（MCP）服务，用于对接 ThemeParks.wiki API。用户可以借此获取主题公园的实时和静态数据，包括目的地、游乐设施、等候时间和日程安排。

前置条件

• Node.js >= 18

设置与安装

1. 克隆代码仓库（如适用）：

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

2. 安装依赖项：

   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 Inspector 调试

你可以使用 MCP Inspector 调试服务：

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

请确保先构建项目（npm run build）。

可用工具

此服务提供以下工具，MCP 客户端可以调用这些工具：

1. list_destinations

   • 描述： 获取所有可用的顶级主题公园目的地列表（例如，Walt Disney World Resort、Universal Orlando Resort）。
   • 参数： 无

2. get_entity_details

   • 描述： 使用实体的唯一 ID，获取特定实体（如公园、游乐设施或餐厅）的详细静态信息。
   • 参数：
     • entity_id（字符串，UUID，必需）：实体的唯一 GUID 标识符。

3. get_entity_children

   • 描述： 获取给定父实体 ID 的所有直接子实体（例如，某个目的地内的所有公园，或某个公园内的所有游乐设施）。
   • 参数：
     • entity_id（字符串，UUID，必需）：父实体的唯一 GUID 标识符。

4. get_entity_live_data

   • 描述： 获取特定实体及其子实体的实时数据，包括游乐设施等候时间、公园开放时间和演出时间。
   • 参数：
     • entity_id（字符串，UUID，必需）：实体的唯一 GUID 标识符。

5. get_entity_schedule

   • 描述： 获取特定实体的运营日程或日历数据。可以指定年份和月份，也可以获取常规日程数据。
   • 参数：
     • entity_id（字符串，UUID，必需）：实体的唯一 GUID 标识符。
     • year（整数，可选）：日程的年份（例如，2025）。若与月份一同使用时省略此参数，则获取常规日程。
     • month（整数，可选）：日程的月份（1-12）。若与年份一同使用时省略此参数，则获取常规日程。指定此参数时必须提供 year。（两者必须同时提供，不能只提供其中一个。）

帮助提示词

此服务还提供 help 提示词：

• help
  • 描述： 概述所有可用工具及其用法。
  • 参数： 无
  • 输出： 一条易于理解的消息，列出所有工具及其描述和参数。