Time MCP Server by PHP

基本能力

产品定位

mcp-time-php 是一个专门用于时间和时区转换的 MCP 服务器，旨在为 LLM 提供精确的时间信息处理和时区转换功能。

核心功能

1. 获取当前时间：支持通过 IANA 时区名称获取特定时区或系统时区的当前时间。
2. 时区转换：支持在不同时区之间转换时间。
3. 自动检测系统时区：默认自动检测系统时区，也可通过配置手动指定。

适用场景

1. 需要获取不同时区当前时间的场景。
2. 需要在不同时区之间转换时间的场景。
3. 需要自动检测系统时区的场景。

工具列表

1. get_current_time：获取特定时区或系统时区的当前时间。
2. 参数：timezone（字符串，IANA 时区名称，如 'America/New_York'）。
3. convert_time：在不同时区之间转换时间。
4. 参数：source_timezone（字符串，源时区）、time（字符串，24小时格式时间）、target_timezone（字符串，目标时区）。

常见问题解答

1. 如何手动指定系统时区？
2. 在配置的 args 列表中添加 --local-timezone=时区名称。
3. 如何调试服务器？
4. 使用 MCP 检查器：npx @modelcontextprotocol/inspector ./bin/time-server。

使用教程

使用依赖

1. 确保已安装 PHP 和 Composer。

安装教程

1. 克隆仓库： bash git clone https://github.com/uzulla/mcp-time-php.git
2. 安装依赖： bash cd mcp-time-php composer install

调试方式

1. 使用 MCP 检查器调试： bash npx @modelcontextprotocol/inspector ./bin/time-server
2. 运行测试： bash composer test

开发

项目结构

• bin/：可执行脚本。
• src/：源代码，包括枚举类、数据模型、服务类等。
• tests/：测试代码。

测试

1. 安装依赖： bash composer install
2. 运行测试： bash composer test

示例问题

1. "现在几点？"（使用系统时区）
2. "东京的时间是几点？"
3. "纽约下午4点时，伦敦是几点？"
4. "将东京时间的上午9:30转换为纽约时间。"

许可证

该项目遵循 MIT 开源许可条款。