
ThemeParks.wiki API MCP Server

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 版本
安装教程
- 构建可执行 JAR 文件:
./gradlew build
构建完成后,JAR 文件将位于 build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar
- (可选) 构建 Docker 镜像:
./gradlew bootBuildImage --imageName=habuma/tpapi-mcp-server
调试方式
- 在 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"
]
}
}
}
- 确保路径正确指向 Java 命令行和 JAR 文件位置
许可证
None