主题公园数据API服务

提供主题公园运营时间、景点等待时间和演出时间等数据的API服务,适用于旅游应用和主题公园信息整合。

  • by habuma
  • Kotlin
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 habuma/tpapi-mcp-server

使用说明

主题公园.wikineneneba API MCP服务器

这是一个MCP服务器,它从 主题公园.wikineneneba API 作为工具。

特性

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

API

工具

  • getEntityChildren
    • 根据公园的实体ID获取公园内的景点和表演列表
    • 输入: entityId (字符串)
  • getEntityScheduleForDate
    • 根据公园的实体ID和特定日期(采用yyyy-MM-dd格式)获取公园的营业时间。
    • 输入:
      • entityId (字符串)
      • date (字符串;yyyy-MM-dd)
  • 获取所有公园
    • 获取所有公园的列表(包括其名称和实体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中使用ThemeParks.wikineneneba API MCP服务器,方法是添加 配置到 claude_desktop_config.json。将以下路径更改为 正确引用Java命令行和可执行文件的位置 JAR文件:

{
  "mcpServers": {
    "tpapi": {
      "command": "/path/to/java",
      "args": [
        "-jar",
        "/path/to/project/build/libs/tpapi-mcp-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}