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