Chrishayuk Chuk MCP Time Server

🚀 MCP 時間サーバー

MCP 時間サーバーは、Python をベースにした高度なマイクロサービスです。このサービスは、異なるタイムゾーン間での時間関連のユーティリティを提供し、現在の時間を取得したり、世界中の様々なタイムゾーン間で時間を変換する機能を備えています。

🚀 クイックスタート

MCP 時間サーバーを使用することで、IANA タイムゾーンの現在の時間を取得したり、異なるタイムゾーン間で時間を変換することができます。以下に基本的な使用方法を示します。

サーバーの起動

コマンドラインインターフェイス

chuk-mcp-time-server

プログラムからの使用

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

時間関連の操作

現在の時間を取得する

get_current_time('Europe/London')

時間を変換する

convert_time('America/New_York', '14:30', 'Europe/Paris')

✨ 主な機能

• 現在の時間を取得する: 任意の IANA タイムゾーンの現在の時間を取得できます。
• タイムゾーンの変換: 異なるタイムゾーン間で時間を変換できます。
• 完全な検証: Pydantic モデルを使用して強力な入力検証を行います。
• 非同期サーバーアーキテクチャ: asyncio を使用して構築されており、効率的なパフォーマンスを実現します。
• 柔軟な設定: 環境変数と設定ファイルを通じて設定可能です。

📦 インストール

前提条件

• Python 3.11 またはそれ以上のバージョン
• pip
• （オプション）仮想環境の使用を推奨します。

PyPI からのインストール

pip install chuk-mcp-time-server

ソースコードからのインストール

1. リポジトリをクローンします。

git clone <repository-url>
cd chuk-mcp-time-server

2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # Windows の場合は `venv\Scripts\activate` を使用します。

3. パッケージをインストールします。

pip install .  # 編集可能なモードでパッケージをインストールします。

開発用のインストール

開発環境をセットアップするには、次のコマンドを実行します。

pip install .[dev]  # 開発用の依存関係を含めてパッケージをインストールします。

📚 ドキュメント

プロジェクトの詳細

依存関係

コア依存関係

• mcp (>=1.6.0)
• pydantic (>=2.11.2)
• PyYAML (>=6.0.2)
• pyz (>=0.4.3)

開発依存関係

• pytest (>=8.3.5)

環境変数

• NO_BOOTSTRAP: コンポーネントのブートストラップを無効にするために設定します。
• その他の設定オプションは、設定ファイルを通じて設定できます。

🔧 技術詳細

コードのフォーマット

• Black を使用してコードをフォーマットします。
• isort を使用してインポートをソートします。
• 行の長さは 88 文字に設定します。

テストの実行

pytest

🤝 貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. コードがフォーマットされ、テストに合格することを確認します。
4. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
5. ブランチにプッシュします (git push origin feature/AmazingFeature)。
6. プルリクエストを開きます。

📄 ライセンス

MIT ライセンス