ParkAlert MCP

MCP-сервер, который предоставляет статус аттракционов Disney и время ожидания в виде инструментов по запросу, на основе API ThemeParks.wiki.

Это pull-ориентированный аналог ParkAlert — PWA, который опрашивает тот же API по таймеру и отправляет уведомление через ntfy.sh, когда аттракцион закрывается или снова открывается. ParkAlert отвечает на вопрос «сообщи мне, когда что-то изменится». Этот сервер отвечает на вопрос «какая ситуация прямо сейчас, потому что я только что спросил». API-клиент портирован из server/themeparks.js проекта ParkAlert; цикл опроса, обнаружение переходов, коды поездок и рассылка уведомлений намеренно оставлены за бортом.

Инструменты

Оба инструмента принимают парк по названию, псевдониму или идентификатору сущности ThemeParks.wiki («Magic Kingdom», «dhs», «epcot»), а аттракцион — так, как его назвал бы человек: частичные и близкие по написанию имена, такие как «space mountain» или «tron», сопоставляются, а при неоднозначном имени возвращаются возможные варианты.

Поддерживаемые парки: Magic Kingdom, EPCOT, Hollywood Studios, Animal Kingdom, Disneyland (CA), California Adventure. Добавить новые можно, дополнив PARKS в src/parkalert_mcp/parks.py.

Related MCP server: Disney Parks MCP Server

Установка

Требуется Python 3.10 или новее (минимальная версия для SDK mcp).

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 не запускается через login shell, поэтому голый python не разрешится в это окружение. Перезапустите Claude Desktop после редактирования, затем ищите инструменты под значком коннекторов.

Авторы

Создано Остином Водраской с помощью Claude.