ThemeParks.wiki API MCP 服务器

这是一个 MCP 服务器，它将 ThemeParks.wiki API 的数据作为工具公开。

功能

• 获取主题公园的运营时间
• 获取游乐设施的等待时间
• 获取表演时间

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（或更高版本）。 我建议使用 SDKMAN! 来安装和管理 Java 版本。

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