ParkAlert MCP

Un servidor MCP que expone el estado de las atracciones de Disney y los tiempos de espera como herramientas bajo demanda, respaldado por la API de ThemeParks.wiki.

Este es el hermano basado en extracción de ParkAlert, una PWA que consulta la misma API con un temporizador y envía una notificación a través de ntfy.sh cuando una atracción se detiene o vuelve a funcionar. ParkAlert responde "avísame cuando algo cambie". Este servidor responde "¿cuál es la situación ahora mismo, porque acabo de preguntar?". El cliente de la API está portado desde server/themeparks.js de ParkAlert; el bucle de sondeo, la detección de transiciones, los códigos de viaje y la distribución de notificaciones se dejan deliberadamente fuera.

Herramientas

Ambas herramientas aceptan un parque por nombre, alias o ID de entidad de ThemeParks.wiki ("Magic Kingdom", "dhs", "epcot"), y una atracción como la diría una persona: se emparejan nombres parciales y casi coincidentes como "space mountain" o "tron", y un nombre ambiguo devuelve los candidatos que podría haber querido decir.

Parques compatibles: Magic Kingdom, EPCOT, Hollywood Studios, Animal Kingdom, Disneyland (CA), California Adventure. Añade más añadiendo a PARKS en src/parkalert_mcp/parks.py.

Related MCP server: Disney Parks MCP Server

Configuración

Requiere Python 3.10 o más reciente (el mínimo del SDK de mcp).

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

Ejecutarlo

El servidor habla por stdio, por lo que lo lanza su cliente en lugar de ejecutarse como un servicio de larga duración. Para probarlo manualmente:

.venv/bin/python -m parkalert_mcp.server

Para un navegador de herramientas interactivo, el Inspector de MCP funciona con el mismo comando:

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

Claude Desktop

Añade el servidor a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

La ruta absoluta al Python del entorno virtual es importante: Claude Desktop no pasa por un shell de inicio de sesión, por lo que un python simple no se resolvería a este entorno. Reinicia Claude Desktop después de editar y luego busca las herramientas bajo el icono de conectores.

Créditos

Creado por Austin Vodrazka con Claude.