ParkAlert MCP

Disneyのアトラクションの運行状況と待ち時間をオンデマンドツールとして公開するMCPサーバーで、ThemeParks.wiki APIをバックエンドとしています。

これは、ParkAlert のプル型の兄弟版です。ParkAlertは同じAPIをタイマーでポーリングし、アトラクションが停止または復旧したときにntfy.sh経由で通知を送るPWAです。ParkAlertは「何かが変わったら教えて」に答え、このサーバーは「いま聞いたから、いまの状況はどうなっているのか」に答えます。APIクライアントはParkAlertのserver/themeparks.jsから移植されていますが、ポーリングループ、状態遷移の検出、tripコード、通知のファンアウトはすべて意図的に除外されています。

ツール

どちらのツールも、パークを名前、別名、または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"]
    }
  }
}

venv 内の Python の絶対パスが重要です。Claude Desktopはログインシェルを通さないため、ただのpython ではこの環境に解決されません。編集後にClaude Desktopを再起動し、コネクタアイコンの下にあるツールを確認してください。

クレジット

Austin Voz冊 が Claude と共に構築しました。