mcp-time-php

🚀 使用PHP实现的时间MCP服务器

本项目通过PHP实现了MCP（模型上下文协议服务器），具备时间获取和时区转换功能。LLM可借助IANA时区名称获取当前时间信息，执行时区转换，服务器还能自动检测系统时区。

🚀 快速开始

此项目借助PHP实现MCP服务器，提供了便捷的时间获取和时区转换功能。下面为你详细介绍安装、配置和使用方法。

📦 安装指南

要安装此项目，请运行以下命令：

composer install

📚 详细文档

配置

MCP服务器配置

编辑 php.ini 文件或创建一个新的配置文件，添加以下内容：

[mcp_server]
server_class = StdioServer
server_port = 12345

环境变量配置

设置以下环境变量以自定义行为：

• MCP_SERVER_ADDRESS：指定服务器绑定的地址，默认为 localhost。
• MCP_SERVER_PORT：指定服务器监听的端口，默认为 12345。

💻 使用示例

基础用法

获取当前时间（使用系统时区）

echo "time now" | mcp-cli

获取特定时区的时间

echo "time now in japan" | mcp-cli

时间转换

echo "what is 2pm in japan in us eastern time?" | mcp-cli

🔧 技术细节

项目结构

项目的文件结构如下：

src/
├── TimeService.php    # 时间服务实现类
├── TimeUtils.php      # 时间工具类
├── StdioServer.php    # MCP服务器实现类
└── Service/           # 服务相关代码
    └── TimeService.php  # 时间服务接口

tests/
├── ServerTest.php     # 服务器单元测试
└── TimeServerTest.php # 时间服务集成测试

测试

运行以下命令执行测试：

composer test

📄 许可证

此项目根据 MIT 许可证发布。

MIT 许可证

版权所有 (c) 2025 六一志

准许任何个人或组织在遵守以下条件的情况下免费使用、复制、修改、合并、发布、分发、 sublicense 和/或出售此软件及其关联的文档文件（“软件”）：

1. 在所有副本或该软件的重大部分中包含上述版权声明和本许可声明。

软件按“原样”提供，不做任何明示或暗示的保证，包括但不限于对适销性、特定用途的适用性和无侵害的保证。在任何情况下，作者或版权所有者均不对因使用此软件或与之相关的行为而产生的任何申述、损害或其他责任负责，无论是在合同诉讼、侵权诉讼还是其他诉讼中。

致谢

该项目包含并翻译了以下开源项目的部分：

• Model Context Protocol Servers (MIT 许可证)
• Model Context Protocol Python SDK (MIT 许可证)