Tpapi MCP Server

🚀 テーマパーク.wiki API MCP サーバー

このサーバーは MCP サーバーであり、テーマパーク.wiki API からのデータをツールとして公開しています。

🚀 クイックスタート

このサーバーは、テーマパークの営業時間やアトラクションの待ち時間、ショーのスケジュールなどの情報を取得するための API を提供します。以下に、主な機能や API の使い方を説明します。

✨ 主な機能

• テーマパークの営業時間を取得する
• アトラクションの待ち時間を取得する
• ショーのスケジュールを取得する

📚 ドキュメント

🔧 API

ツール

• getEntityChildren
  • 公園のエンティティ ID を基に、公園内の一連のエンターテインメントやショーのリストを返します。
  • 入力: entityId (文字列)
• getEntityScheduleForDate
  • 公園のエンティティ ID と特定の日付（形式: yyyy-MM-dd）を基に、公園の営業時間を取得します。
  • 入力:
    • entityId (文字列)
    • date (文字列; yyyy-MM-dd)
• getAllParks
  • すべての公園のリスト（名前とエンティティ ID を含む）を取得します。
• getParksByName
  • 公園名またはリゾート名を基に、公園のリスト（名前とエンティティ ID を含む）を取得します。
  • 入力: searchTerm (文字列)
• 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 でテーマパーク.wiki API MCP サーバーを使用するには、claude_desktop_config.json ファイルに設定を追加します。以下のパスを適切なものに変更してください。

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