ThemeParks.wiki API MCP Server

ThemeParks.wiki API MCP サーバー

ThemeParks.wiki API のデータをツールとして公開する MCP サーバーです。

機能

• テーマパークの営業時間を取得
• アトラクションの待ち時間を取得
• ショーの開始時間を取得

API

ツール

• getEntityChildren
  • パークのエンティティ ID を指定して、パーク内のアトラクションとショーの一覧を取得します
  • 入力：entityId（文字列）
• getEntityScheduleForDate
  • パークのエンティティ ID と特定の日付（yyyy-MM-dd 形式）を指定して、パークの営業時間を取得します。
  • 入力：
    • entityId（文字列）
    • date（文字列；yyyy-MM-dd）
• getAllParks
  • すべてのパークの一覧（名前とエンティティ ID を含む）を取得します
• getParksByName
  • パーク名またはリゾート名を指定して、パークの一覧（名前とエンティティ ID を含む）を取得します
  • 入力：entityId（文字列）
• getEntity
  • エンティティ ID を指定して、エンティティを取得します
  • 入力：entityId（文字列）
• getEntityLive
  • アトラクションまたはショーのエンティティ ID を指定して、アトラクションの待ち時間またはショーの開始時間を取得します
  • 入力：entityId（文字列）

サーバーのビルド

サーバーを実行可能な JAR ファイルとしてビルドするには、次のコマンドを実行します。

./gradlew build

Java 21 以降をインストールする必要があります。Java のバージョンのインストールと管理には、SDKMAN! の使用をおすすめします。

JAR ファイルは build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar に配置されます。 この実行可能 JAR ファイルを自分で実行しないでください。MCP クライアント（Claude Desktop など）がサーバーを実行します。

任意で、サーバーを Docker イメージとしてビルドするには、次のコマンドを実行します。

./gradlew bootBuildImage --imageName=habuma/tpapi-mcp-server

この Docker イメージを自分で実行しないでください。MCP クライアント（Claude Desktop など）がサーバーを実行します。

Claude Desktop での使用方法

claude_desktop_config.json に設定を追加することで、Claude Desktop で ThemeParks.wiki API MCP サーバーを使用できます。以下のパスを、Java のコマンドラインと実行可能 JAR ファイルの場所を正しく参照するように変更してください。

{
  "mcpServers": {
    "tpapi": {
      "command": "/path/to/java",
      "args": [
        "-jar",
        "/path/to/project/build/libs/tpapi-mcp-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}