使用说明

项目简介

World Time MCP Server 是一个示例 MCP 服务器，旨在演示如何使用 Spring AI MCP 框架构建一个为大型语言模型 (LLM) 提供上下文信息的后端服务。该服务器提供了一个工具，允许 LLM 获取当前时间，数据来源于公共的 World Time API。

主要功能点

提供当前时间工具: 通过集成的 World Time API，LLM 可以调用该服务器获取准确的当前时间信息。
MCP 服务器: 遵循 Model Context Protocol (MCP) 协议，可以与任何兼容 MCP 协议的 LLM 客户端进行通信。
易于部署: 基于 Spring Boot 构建，可以使用 Maven 轻松构建和运行。

安装步骤

克隆仓库

git clone https://github.com/cpage-pivotal/time-mcp.git
cd time-mcp

构建服务器
- 确保已安装 JDK 17+ 和 Maven。
- 运行 Maven 命令进行构建：
```
./mvnw clean package
```
- 构建成功后，JAR 文件将位于 'target' 目录下，文件名为 'time-mcp-0.0.1-SNAPSHOT.jar'。
- 或者，您可以直接从 Releases 页面下载预构建的服务器 JAR 文件。

服务器配置

MCP 服务器需要配置后才能被 MCP 客户端（如 Claude Desktop）发现和连接。您需要在 MCP 客户端的配置文件中添加服务器的配置信息。以 Claude Desktop 客户端为例，您需要编辑 'claude_desktop_config.json' 文件（通常位于 '~/Library/Application\ Support/Claude/' 目录下）。

在 'claude_desktop_config.json' 文件的 'mcpServers' 字段中添加或修改配置，示例如下：

{
  "mcpServers": {
    "time-mcp": {  // 服务器名称，客户端配置中用于标识该服务器
      "command": "java",  // 启动服务器的命令，这里使用 java 命令
      "args": [  // 启动参数列表
        "-Dlogging.file.name=time-mcp.webmvc.log",  // 可选参数：设置日志文件名称
        "-jar",  // 必须参数：指定要执行的 JAR 文件
        "/path/to/time-mcp/target/time-mcp-0.0.1-SNAPSHOT.jar",  // 必须参数：服务器 JAR 文件的绝对路径，请替换为实际路径
        "--server.port=8022"  // 可选参数：设置服务器端口号，默认为 8080，这里设置为 8022
      ]
    }
  }
}

请注意：

将 '/path/to/time-mcp/target/time-mcp-0.0.1-SNAPSHOT.jar' 替换为您实际的 JAR 文件路径。
可以根据需要修改端口号 '--server.port'，确保端口未被占用。
配置文件路径和名称可能因 MCP 客户端而异，请参考您使用的 MCP 客户端的文档。

基本使用方法

启动服务器: 在终端中，使用配置中指定的 'command' 和 'args' 启动服务器。例如，如果您的 JAR 文件路径配置正确，可以直接在终端中执行配置中的 'command' 和 'args' 命令。
配置 MCP 客户端: 按照上述“服务器配置”步骤，配置您的 MCP 客户端，使其能够发现并连接到 World Time MCP Server。
在 LLM 中使用: 一旦客户端成功连接到服务器，您就可以在 LLM 中使用 "get current time" 工具了。具体的调用方式取决于您使用的 LLM 客户端的接口。通常，您可以通过自然语言指令或特定的客户端命令来指示 LLM 使用该工具。例如，您可以询问 "现在几点了？" 或 "当前时间是什么？"，如果 LLM 客户端支持工具调用，它可能会调用 World Time MCP Server 获取时间信息并返回给您。

关键词