Time Server - MCP 服务器使用说明

项目简介

Time Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为 LLM 应用提供时间相关的上下文信息和功能。它通过 MCP 协议与客户端通信，提供标准化的工具调用接口，使 LLM 能够轻松获取当前时间、进行时区转换等操作。

主要功能点

• 获取当前时间：可以查询任意 IANA 时区标识符所代表时区的当前时间。
• 时区转换：支持将特定时间从一个时区转换为另一个时区。
• MCP 协议标准：完全遵循 Model Context Protocol 协议，易于集成到支持 MCP 协议的 LLM 客户端。

安装步骤

1. 环境准备：确保已安装 Python 3.10 或更高版本，并配置好 pip 包管理器。
2. 下载仓库：将仓库代码克隆到本地或下载 ZIP 文件并解压。
3. 安装依赖：在仓库根目录下打开终端，执行以下命令安装 Time Server：

   pip install .
   

服务器配置

为了让 MCP 客户端能够连接到 Time Server，您需要在客户端中配置以下服务器信息。以下是 JSON 格式的配置示例，通常在 MCP 客户端的服务器管理或插件配置中添加：

{
  "serverName": "mcp-time",
  "command": "python",
  "args": ["-m", "time_server"]
}

配置参数说明：

• 'serverName': 服务器名称，用于在 MCP 客户端中标识和管理 Time Server，可以自定义，例如 "Time Server"。
• 'command': 启动服务器的命令，这里指定使用 'python' 解释器来运行。
• 'args': 启动命令的参数，'["-m", "time_server"]' 表示以模块方式运行 'time_server'，这是 Time Server 的主程序入口。

注意： 确保您的 Python 环境配置正确，'python' 命令指向的是安装了 Time Server 的 Python 环境。

基本使用方法

1. 启动服务器：在安装完成后，无需手动启动服务器。当 MCP 客户端需要使用 Time Server 的功能时，客户端会根据配置自动启动服务器。

2. 调用工具：在支持 MCP 协议的 LLM 应用中，您可以使用自然语言指令来指示 LLM 调用 Time Server 提供的工具。例如：

   • 获取当前时间：您可以指示 LLM "现在纽约时间几点？" 或 "请查询东京的当前时间"。LLM 客户端会将这些指令转换为对 'get_current_time' 工具的调用，并传递相应的时区参数（如 "America/New_York", "Asia/Tokyo"）。
   • 时区转换：您可以指示 LLM "将下午3点纽约时间转换为北京时间" 或 "我想知道伦敦时间早上9点对应东京时间几点"。LLM 客户端会将这些指令转换为对 'convert_time' 工具的调用，并传递源时区、目标时区和时间参数。

3. 查看结果：Time Server 会将查询结果以 JSON 格式返回给 LLM 客户端，客户端会将结果整合到回复中，呈现给用户。

通过以上步骤，您就可以在支持 MCP 协议的 LLM 应用中使用 Time Server 提供的强大时间处理能力了。