Mcp Server For Themeparks.wiki

ThemeParks.wiki 用 MCP サーバー（mcp-server-theme-parks）

このプロジェクトは、ThemeParks.wiki API と連携する Model-Context-Protocol（MCP）サーバーを提供します。テーマパークの目的地、アトラクション、待ち時間、スケジュールなど、リアルタイムデータと静的データにアクセスできます。

前提条件

• Node.js >= 18

セットアップとインストール

1. リポジトリをクローンします（該当する場合）：

   git clone https://github.com/MasonMao-dev/mcp-server-theme-parks.git
   cd mcp-server-theme-parks
   

2. 依存関係をインストールします：

   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 Inspector を使用したデバッグ

MCP Inspector を使用してサーバーをデバッグできます：

npx @modelcontextprotocol/inspector -e THEMEPARKS_API_BASE_URL=https://api.themeparks.wiki/v1 node dist/index.js

最初にプロジェクトをビルドしてください（npm run build）。

利用可能なツール

サーバーは、MCP クライアントから呼び出せる次のツールを公開します：

1. list_destinations

   • 説明： 利用可能なすべての主要なテーマパークの目的地（例：Walt Disney World Resort、Universal Orlando Resort）の一覧を取得します。
   • パラメーター： なし

2. get_entity_details

   • 説明： 一意の ID を使用して、特定のエンティティ（パーク、アトラクション、レストランなど）の詳細な静的情報を取得します。
   • パラメーター：
     • entity_id（文字列、UUID、必須）：エンティティを識別する一意の GUID。

3. get_entity_children

   • 説明： 指定した親エンティティ ID のすべての直接の子エンティティを取得します（例：目的地内のすべてのパーク、またはパーク内のすべてのアトラクション）。
   • パラメーター：
     • entity_id（文字列、UUID、必須）：親エンティティを識別する一意の GUID。

4. get_entity_live_data

   • 説明： 特定のエンティティとその子エンティティのライブデータを取得します。アトラクションの待ち時間、パークの営業時間、ショーの時間などが含まれます。
   • パラメーター：
     • entity_id（文字列、UUID、必須）：エンティティを識別する一意の GUID。

5. get_entity_schedule

   • 説明： 特定のエンティティの営業時間スケジュールまたはカレンダーデータを取得します。年と月を指定するか、一般的なスケジュールデータを取得できます。
   • パラメーター：
     • entity_id（文字列、UUID、必須）：エンティティを識別する一意の GUID。
     • year（整数、任意）：スケジュールの年（例：2025）。月を指定せずにこのパラメーターを省略すると、一般的なスケジュールを取得します。
     • month（整数、任意）：スケジュールの月（1～12）。年を指定せずにこのパラメーターを省略すると、一般的なスケジュールを取得します。指定する場合はyearが必要です（一方を指定する場合は、両方の年と月を指定する必要があります）。

ヘルププロンプト

サーバーはhelpプロンプトも提供します：

• help
  • 説明： 利用可能なすべてのツールとその使い方の概要を提供します。
  • パラメーター： なし
  • 出力： すべてのツール、その説明、パラメーターを一覧表示する、ユーザー向けのメッセージ。