使用说明

项目简介

ThemeParks.wiki API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它将 ThemeParks.wiki API 的数据以工具的形式暴露出来，供 LLM 客户端使用。这意味着你可以通过支持 MCP 协议的 LLM 客户端（如 Claude Desktop）来查询主题公园的各种信息，例如开放时间、游乐设施等待时间、表演时间等。

主要功能点

查询主题公园信息: 提供多种工具，允许 LLM 客户端获取主题公园、游乐设施和表演的详细信息。
实时数据访问: 可以获取主题公园的实时运营数据，例如游乐设施的等待时间和表演的演出时间。
标准化接口: 遵循 MCP 协议，提供标准化的 JSON-RPC 接口，易于集成到支持 MCP 的 LLM 应用中。

安装步骤

安装 Java 环境: 确保你的计算机上已安装 Java 21 或更高版本。如果没有安装，请先安装 Java 21 或更高版本。推荐使用 SDKMAN! 来管理和安装 Java 版本。
下载代码: 从 GitHub 仓库 https://github.com/habuma/tpapi-mcp-server 下载或克隆代码到本地。
构建服务器: 打开终端，进入代码仓库的根目录。运行命令 './gradlew build' 来构建可执行的 JAR 文件。构建成功后，JAR 文件将位于 'build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar'。

服务器配置

MCP 服务器是为 MCP 客户端设计的，你需要将服务器配置添加到 MCP 客户端的配置文件中。以 Claude Desktop 为例，你需要编辑 'claude_desktop_config.json' 文件，添加以下配置信息。请根据你的实际 Java 安装路径和 JAR 文件路径进行修改：

{
  "mcpServers": {
    "tpapi": {
      "server name": "tpapi",
      "command": "/path/to/java",  //  请替换为你的 Java 命令的完整路径，例如：/usr/bin/java 或 C:\Program Files\Java\jdk-21\bin\java.exe
      "args": [
        "-jar",
        "/path/to/project/build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar" // 请替换为 JAR 文件的实际路径，例如：/Users/yourname/Downloads/tpapi-mcp-server-main/build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar
      ]
    }
  }
}

配置说明:

'"server name": "tpapi"': 为该 MCP 服务器定义一个名称，例如 "tpapi"，客户端将使用此名称来引用该服务器。
'"command": "/path/to/java"': 指定 Java 运行时的命令路径。确保指向你安装的 Java 21 或更高版本的 'java' 可执行文件。
'"args": [...]': 指定启动服务器 JAR 文件所需的参数。 '"-jar"' 参数告诉 Java 虚拟机运行 JAR 文件，'/path/to/project/build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar' 是构建生成的 JAR 文件的完整路径。

基本使用方法

完成配置后，启动你的 MCP 客户端（例如 Claude Desktop）。客户端会自动根据配置文件启动 ThemeParks.wiki API MCP Server。你可以在 LLM 客户端中使用自然语言指令，结合服务器提供的工具来查询主题公园信息。例如，你可以询问 "东京迪士尼乐园的营业时间是什么？" 或 "环球影城冒险岛有哪些游乐设施？"。 LLM 客户端会根据你的问题，自动调用 MCP 服务器提供的工具来获取答案。具体的工具列表和使用方法，请参考仓库的 README.md 文件中 "API/Tools" 部分的详细描述。

关键词