MCP Time Php

🚀 PHPで実装された時間MCPサーバー

PHPで実装されたMCP（モデルコンテキストプロトコルサーバー）は、時間の取得とタイムゾーン変換機能を提供します。このサーバーは、LLMがIANAタイムゾーン名を使用して現在の時間情報を取得し、タイムゾーン変換を実行することを可能にし、同時にシステムのタイムゾーンを自動検出します。

📦 インストール

このプロジェクトをインストールするには、以下のコマンドを実行してください。

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ライセンス

Copyright (c) 2025 六一志

以下の条件を満たす場合、個人または組織はこのソフトウェアおよび関連するドキュメントファイル（「ソフトウェア」）を無料で使用、コピー、変更、統合、公開、配布、サブライセンスおよび/または販売することが許可されます。

1. すべてのコピーまたはソフトウェアの重要な部分に、上記の著作権表示とこのライセンス表示を含めること。

ソフトウェアは「現状のまま」提供され、明示的または暗示的な保証を一切伴わず、商品性、特定の目的への適合性、および非侵害の保証を含みません。いかなる場合も、作者または著作権所有者は、ソフトウェアの使用または関連する行為に起因するいかなる申し立て、損害、またはその他の責任についても、契約訴訟、不法行為訴訟、またはその他の訴訟において責任を負いません。

謝辞

このプロジェクトには、以下のオープンソースプロジェクトの一部が含まれており、翻訳されています。

• Model Context Protocol Servers (MIT ライセンス)
• Model Context Protocol Python SDK (MIT ライセンス)