主题公园的MCP服务器.wiki(mcp-server-theme-parks)
该项目提供了一个模型上下文协议（MCP）服务器，该服务器与 主题公园.wikineneneba API。它允许用户访问主题公园的实时和静态数据，包括目的地、景点、等待时间和时间表。
先决条件
- Node.js>=18
设置和安装
- 克隆存储库（如果适用）：
git clone https://github.com/MasonMao-dev/mcp-server-theme-parks.git
cd mcp-server-theme-parks- 安装依赖项：
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客户端调用的工具：
list_destinations
- 说明： 检索所有可用顶级主题公园目的地的列表（例如，华特迪士尼世界度假区、奥兰多环球影城度假区）。 - 参数： 无
get_entity_details
- 说明： 使用特定实体（如公园、景点或餐厅）的唯一ID获取其详细的静态信息。 - 参数： - entity_id （字符串，UUID，必填）：实体的唯一GUID标识符。
get_entity_children
- 说明： 检索给定父实体ID的所有直接子实体（例如，目的地内的所有公园或公园内的所有景点）。 - 参数： - entity_id （字符串，UUID，必填）：父实体的唯一GUID标识符。
get_entity_live_data
- 说明： 获取特定实体及其子实体的实时数据。这可能包括景点等待时间、公园运营时间和表演时间。 - 参数： - entity_id （字符串，UUID，必填）：实体的唯一GUID标识符。
get_entity_schedule
- 说明： 检索特定实体的操作计划或日历数据。可以指定年和月，或获取常规日程数据。 - 参数： - entity_id （字符串，UUID，必填）：实体的唯一GUID标识符。 - year （整数，可选）：日程表的年份（例如2025年）。如果省略月份，则取总计划。 - month （整数，可选）：日程表的月份（1-12）。如果省略年份，则取总进度表。需要 year 如果指定。（如果有，必须提供年份和月份。）
帮助提示
服务器还提供 help 提示：
help
- 说明： 提供所有可用工具及其用法的摘要。 - 参数： 无 - 输出： 一条用户友好的消息，列出了所有工具、它们的描述和参数。