ThemeParks.wiki API MCP Server

ThemeParks.wiki API MCP Server

site icon
2025.02.15 3
Kotlin主题公园数据服务娱乐信息查询娱乐功能
tpapi-mcp-server 是一个基于 ThemeParks.wiki API 的 MCP 服务器,主要用于提供主题公园相关的数据服务。该服务器通过暴露 ThemeParks.wiki API 的功能作为工具,帮助用户获取主题公园的运营时间、景点等待时间以及演出时间等信息。
View on GitHub

Overview

基本能力

产品定位

tpapi-mcp-server 是一个数据服务工具,专注于提供主题公园相关的实时和计划数据。

核心功能

  • 获取主题公园的运营时间
  • 获取景点的等待时间
  • 获取演出的时间表

适用场景

  • 主题公园游客计划行程
  • 实时监控景点等待时间
  • 查看演出时间安排

工具列表

  • getEntityChildren: 获取指定公园的所有景点和演出列表
  • 输入: entityId (字符串)
  • getEntityScheduleForDate: 获取指定公园在特定日期的运营时间
  • 输入:
    • entityId (字符串)
    • date (字符串; yyyy-MM-dd格式)
  • getAllParks: 获取所有公园的列表(包括名称和实体ID)
  • getParksByName: 根据公园或度假村名称获取公园列表
  • 输入: entityId (字符串)
  • getEntity: 根据实体ID获取实体信息
  • 输入: entityId (字符串)
  • getEntityLive: 获取景点的实时等待时间或演出的时间表
  • 输入: entityId (字符串)

常见问题解答

  • 该服务需要由 MCP 客户端(如 Claude Desktop)运行,用户不应直接运行 JAR 文件或 Docker 镜像。
  • 需要 Java 21 或更高版本支持。

使用教程

使用依赖

  • 需要安装 Java 21 或更高版本
  • 推荐使用 SDKMAN! 管理 Java 版本

安装教程

  1. 构建可执行 JAR 文件:
./gradlew build

构建完成后,JAR 文件将位于 build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar

  1. (可选) 构建 Docker 镜像:
./gradlew bootBuildImage --imageName=habuma/tpapi-mcp-server

调试方式

  1. 在 Claude Desktop 中使用时,需要配置 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"
      ]
    }
  }
}
  1. 确保路径正确指向 Java 命令行和 JAR 文件位置

许可证

None