MCP Time Server

MCP Time Server

概要

MCP Time Server は、さまざまなタイムゾーンで高度な時間関連ユーティリティを提供する、洗練された Python ベースのマイクロサービスです。現在時刻の取得や、世界各地のタイムゾーン間での時刻変換に対応する堅牢な機能を備えています。

プロジェクトの詳細

• バージョン：0.1.1
• Python の互換性：Python 3.11 以降

機能

• 現在時刻の取得：任意の IANA タイムゾーンの現在時刻を取得します
• タイムゾーン変換：異なるタイムゾーン間で時刻を変換します
• 包括的な検証：Pydantic モデルを使用して堅牢な入力検証を行います
• 非同期サーバーアーキテクチャ：効率的なパフォーマンスを実現するため、asyncio で構築されています
• 柔軟な設定：環境変数と設定ファイルから設定できます

依存関係

コア依存関係：

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

開発用依存関係：

• pytest (>=8.3.5)

インストール

前提条件

• Python 3.11 以降
• pip
• （任意）仮想環境の使用を推奨します

PyPI からインストール

pip install chuk-mcp-artifact-server

ソースからインストール

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

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

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

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

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

pip install .  # Installs the package in editable mode

開発用インストール

開発環境をセットアップするには：

pip install .[dev]  # Installs package with development dependencies

サーバーの実行

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

chuk-mcp-artifact-server

プログラムからの使用

from chuk_mcp_artifact_server.main import main

if __name__ == "__main__":
    main()

環境変数

• NO_BOOTSTRAP：コンポーネントのブートストラップを無効にする場合に設定します
• その他の設定オプションは設定ファイルで指定できます

利用可能なツール

1. 現在時刻の取得

入力：

• timezone：IANA タイムゾーン名（例：'America/New_York'）

例：

get_current_time('Europe/London')

戻り値：

• 指定したタイムゾーンの現在時刻
• タイムゾーンの詳細
• 夏時間（DST）の状態

2. 時刻の変換

入力：

• source_timezone：変換元のタイムゾーン（IANA 形式）
• time：HH:MM（24 時間形式）の時刻
• target_timezone：変換先のタイムゾーン（IANA 形式）

例：

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

戻り値：

• 変換元時刻の詳細
• 変換先時刻の詳細
• タイムゾーン間の時差

開発

コードのフォーマット

• コードのフォーマットには 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 ライセンス