ParkAlert MCP

一个 MCP 服务器，将迪士尼乐园的游乐设施状态和等待时间作为按需工具暴露出来， 由 ThemeParks.wiki API 提供支持。

这是 ParkAlert 的拉取式姊妹项目， 后者是一个 PWA，它按定时器轮询同一 API，并在游乐设施关闭或恢复时通过 ntfy.sh 推送通知。ParkAlert 回答“当有变化时告诉我”。这个服务器回答“现在是什么情况，因为我刚刚问了”。 API 客户端是从 ParkAlert 的 server/themeparks.js 移植过来的；轮询循环、 状态转换检测、行程代码和通知分发都被有意地留下。

工具

两个工具都接受公园的名称、别名或 ThemeParks.wiki 实体 ID （“Magic Kingdom”、“dhs”、“epcot”），以及游乐设施的名称——支持模糊匹配， 例如“space mountain”或“tron”这样的部分和近似名称，如果有歧义， 会返回它可能指的是哪些候选。

支持的公园：Magic Kingdom、EPCOT、Hollywood Studios、Animal Kingdom、 Disneyland (CA)、California Adventure。要添加更多公园，请在 src/parkalert_mcp/parks.py 中追加到 PARKS。

Related MCP server: Disney Parks MCP Server

设置

需要 Python 3.10 或更高版本（mcp SDK 的最低要求）。

python3.12 -m venv .venv
.venv/bin/pip install -e .

运行

服务器使用 stdio 通信，因此由客户端启动，而不是作为常驻服务运行。 要手动测试：

.venv/bin/python -m parkalert_mcp.server

对于交互式工具浏览器，MCP Inspector 可以针对同一命令运行：

npx @modelcontextprotocol/inspector .venv/bin/python -m parkalert_mcp.server

Claude Desktop

将服务器添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "parkalert": {
      "command": "/Users/austin/parkalert-mcp/.venv/bin/python",
      "args": ["-m", "parkalert_mcp.server"]
    }
  }
}

虚拟环境中 Python 的绝对路径很重要：Claude Desktop 不通过登录 shell 运行， 因此裸 python 无法解析到这个环境。编辑后重启 Claude Desktop， 然后在连接器图标下查找这些工具。

致谢

由 Austin Vodrazka 使用 Claude 构建。