Chuk MCP Time Server

🚀 MCP 時間服務器

MCP 時間服務器是一款功能強大的 Python 微服務，支持多種時區，提供高級的時間相關實用工具。它能獲取當前時間，並在不同全球時區之間進行時間轉換，為用戶帶來極大便利。

🚀 快速開始

運行服務器

命令行界面

chuk-mcp-time-server

編程式使用

from chuk_mcp_time_server.main import main

if __name__ == "__main__":
    main()

✨ 主要特性

• 當前時間獲取：可獲取任意 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]  # 安裝帶開發依賴的包

💻 使用示例

基礎用法

獲取當前時間

get_current_time('Europe/London')

輸入：

• timezone：IANA 時區名稱（例如，'America/New_York'）

返回：

• 指定時區的當前時間
• 時區詳細信息
• 夏令時 (DST) 狀態

轉換時間

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

輸入：

• source_timezone：源時區（IANA 格式）
• time：時間，格式為 HH:MM（24 小時制）
• target_timezone：目標時區（IANA 格式）

返回：

• 源時間詳細信息
• 目標時間詳細信息
• 兩個時區之間的時差

📚 詳細文檔

項目詳情

依賴項

核心依賴

• 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