JinDaGe - tpapi-mcp-server MCP Details

article

README

🚀 主题公园.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"
      ]
    }
  }
}

tpapi-mcp-server