Tpapi MCP Server

🚀 主題公園.wiki API MCP 服務器

這是一個 MCP 服務器，它將來自 主題公園.wiki 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 文件

要將服務器構建為可執行的 JAR 文件，請運行以下命令:

./gradlew build

這需要安裝 Java 21 或更高版本。建議使用 SDKMAN! 來安裝和管理 Java 版本。

JAR 文件將位於 build/libs/kt - mcp - server - 0.0.1 - SNAPSHOT.jar 中。⚠️ 請勿自行運行此可執行 JAR 文件。MCP 客戶端（例如 Claude Desktop）會為您啟動服務器。

構建 Docker 鏡像

作為可選操作，要將服務器構建為 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"
      ]
    }
  }
}