使用说明

项目简介

Time MCP Server (PHP) 是一个使用PHP开发的MCP服务器，旨在为大型语言模型（LLM）应用提供时间和时区相关的上下文信息。通过此服务器，LLM可以获取指定时区的当前时间，并在不同时区之间进行时间转换，从而增强LLM在处理时间相关任务时的能力。

主要功能点

获取当前时间 (get_current_time): 允许LLM获取指定IANA时区的当前时间。如果未指定时区，则默认使用服务器的系统时区。
时区转换 (convert_time): 支持LLM将特定时间从一个IANA时区转换为另一个时区。

安装步骤

克隆仓库:

git clone https://github.com/uzulla/mcp-time-php.git
cd mcp-time-php

安装依赖: 确保你的系统已安装 PHP 和 Composer。然后使用 Composer 安装项目依赖：
```
composer install
```

服务器配置

为了让MCP客户端（如 Claude、Zed 等）连接到 Time MCP Server，您需要在客户端中配置服务器信息。配置信息通常以 JSON 格式指定，包含服务器的名称、启动命令及其参数。

以下是一些 MCP 客户端配置示例，您需要根据您的实际环境进行调整：

Claude.app 配置示例:

在 Claude.app 的 MCP 服务器配置中，您可以添加一个名为 'time' 的服务器配置项。'command' 字段指定了 PHP 解释器的路径，'args' 字段是一个数组，包含了运行 'time-server' 脚本的路径。

"mcpServers": {
  "time": {
    "command": "php",
    "args": ["/path/to/this/repo/bin/time-server"]
  }
}

请将 '/path/to/this/repo/bin/time-server' 替换为 'time-server' 脚本在您系统中的实际路径。

Zed 配置示例:

在 Zed 编辑器的 'settings.json' 文件中，您可以在 'context_servers' 部分添加 'mcp-server-time' 服务器配置。同样，'command' 和 'args' 字段需要正确配置 PHP 解释器和 'time-server' 脚本的路径。

"context_servers": {
  "mcp-server-time": {
    "command": "php",
    "args": ["/path/to/this/repo/bin/time-server"]
  }
},

同样，请务必更新 '/path/to/this/repo/bin/time-server' 为正确的脚本路径。

自定义系统时区:

默认情况下，服务器会自动检测系统时区。如果您希望覆盖默认时区，可以在 'args' 列表中添加 '--local-timezone' 参数，并指定 IANA 时区名称。例如，将服务器时区设置为 "America/New_York"：

{
  "command": "php",
  "args": ["/path/to/this/repo/bin/time-server", "--local-timezone=America/New_York"]
}

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以通过自然语言指令或工具调用来使用 Time MCP Server 提供的功能。

示例指令:

“现在几点？” (使用系统默认时区)
“东京现在几点？” (获取东京时间)
“纽约下午4点时，伦敦是几点？” (进行时区转换)

工具调用示例 (JSON 格式):

1. 获取当前时间 (get_current_time):

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

2. 时区转换 (convert_time):

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

LLM 客户端会将这些工具调用请求发送到 Time MCP Server，服务器处理请求后返回包含时间信息的 JSON 响应。

关键词