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 許可證)