Chuk MCP Time Server

🚀 MCP 時間サーバー

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

🚀 クイックスタート

MCP 時間サーバーは、Python で開発されたマイクロサービスで、様々なタイムゾーンでの時間取得や変換をサポートします。以下では、このサーバーのインストール方法や使い方を説明します。

✨ 主な機能

• 現在時間の取得：任意の 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]  # 開発用依存関係を含むパッケージをインストール

💻 使用例

基本的な使用法

コマンドラインインターフェースでの実行

chuk-mcp-time-server

プログラムでの使用

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

高度な使用法

1. 現在時間の取得

get_current_time('Europe/London')

入力:

• timezone: IANA タイムゾーン名（例: 'America/New_York'） 戻り値:
• 指定されたタイムゾーンの現在時間
• タイムゾーンの詳細情報
• 夏時間 (DST) の状態

2. 時間の変換

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

入力:

• source_timezone: 元のタイムゾーン（IANA 形式）
• time: 時間（24 時間制の HH:MM 形式）
• target_timezone: 変換先のタイムゾーン（IANA 形式） 戻り値:
• 元の時間の詳細情報
• 変換後の時間の詳細情報
• 2 つのタイムゾーン間の時差

📚 ドキュメント

プロジェクト詳細

依存関係

コア依存関係

• 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. Pull Request を開きます。

📄 ライセンス

MIT License