Chrishayuk 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]  # 使用開發依賴項安裝包

💻 使用示例

基礎用法

1. 獲取當前時間

# 輸入:
# - `timezone`: IANA 時區名稱（例如 'America/New_York'）
# 返回:
# - 指定時區的當前時間
# - 時區詳細信息
# - 夏令時 (DST) 狀態
get_current_time('Europe/London')

2. 轉換時間

# 輸入:
# - `source_timezone`: 源時區（IANA 格式）
# - `time`: 時間，格式為 HH:MM（24 小時制）
# - `target_timezone`: 目標時區（IANA 格式）
# 返回:
# - 源時間詳細信息
# - 目標時間詳細信息
# - 時區之間的時差
convert_time('America/New_York', '14:30', 'Europe/Paris')

📚 詳細文檔

項目詳情

依賴項

核心依賴項

• 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 許可證。