使用说明

项目简介

'mcp-simple-timeserver' 是一个实现了 Model Context Protocol (MCP) 的简单服务器，它弥补了部分LLM（如Claude）缺乏时间信息的问题。通过提供 'get_time' 和 'get_utc' 两个工具，使LLM能够获取用户所在地的本地时间和标准的UTC时间，从而增强LLM的时间感知能力。

主要功能点

获取本地时间: 提供 'get_time' 工具，返回运行 MCP 客户端的设备当前所在地的日期、时间和时区信息。这使得LLM能够了解用户的本地时间。
获取UTC时间: 提供 'get_utc' 工具，从网络时间协议 (NTP) 服务器获取并返回精确的协调世界时 (UTC)。这为LLM提供了标准的全球时间参考。

安装步骤

前提条件: 确保您的系统已安装 Python 3.10 或更高版本，并且已配置好 pip 包管理器。
安装Python包: 打开终端或命令提示符，运行以下命令安装 'mcp-simple-timeserver' Python 包：
```
pip install mcp-simple-timeserver
```

服务器配置

要将 'mcp-simple-timeserver' 集成到支持 MCP 协议的LLM客户端（如 Claude 桌面应用），您需要在客户端的配置文件中添加服务器配置信息。以下是一个配置示例，您需要根据您的MCP客户端的具体配置方法进行设置。

通常，您需要提供服务器的名称 (server name)、启动命令 (command) 和命令参数 (args)。对于 'mcp-simple-timeserver'，推荐的配置如下：

"mcpServers": {
  "simple-timeserver": {
    "command": "python",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

配置参数说明:

'server name': 'simple-timeserver' - 这是您为该时间服务器定义的名称，在客户端配置中用于唯一标识和引用此服务器。
'command': 'python' - 这是用于启动服务器的命令。这里假设 'python' 命令在您的系统环境变量 'PATH' 中，可以直接执行。
'args': '["-m", "mcp_simple_timeserver"]' - 这是传递给 'python' 命令的参数。'-m mcp_simple_timeserver' 告诉 Python 解释器以模块的方式运行 'mcp_simple_timeserver' 包，从而启动服务器程序。

注意:

如果您的 Python 可执行文件路径不在系统 'PATH' 环境变量中，或者您希望使用特定版本的 Python，您需要将 'command' 配置项修改为 Python 可执行文件的完整路径。例如，在 Windows 系统中，可能是 '"command": "C:\Users\YourUsername\AppData\Local\Programs\Python\Python310\python.exe"'。请根据您的实际 Python 安装路径进行调整。
大部分MCP客户端会自动处理与MCP服务器的连接和通信，您只需正确配置服务器启动信��即可。

基本使用方法

启动MCP客户端: 启动您配置了 'mcp-simple-timeserver' 的 MCP 客户端应用。客户端通常会自动尝试连接并运行配置的 MCP 服务器。
在LLM中使用工具: 在与LLM的对话中，您可以指示LLM使用 'get_time' 或 'get_utc' 工具来获取时间信息。具体的调用方式取决于LLM客户端的功能和提示词设计。例如，您可以提示 Claude: "现在是什么时间？请使用 'get_time' 工具获取本地时间。" LLM 在接收到指令后，如果配置正确，应该能够调用 'mcp-simple-timeserver' 提供的工具，并将返回的时间信息用于生成回复。

通过以上步骤，您就可以在支持 MCP 协议的 LLM 应用中使用 'mcp-simple-timeserver' 提供的本地时间和 UTC 时间服务，增强 LLM 的时间感知能力。

关键词