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"
      ]
    }
  }
}