Timezone Toolkit

🚀 TimezoneToolkit 中文文檔

TimezoneToolkit 是一個強大的時間和時區工具包，藉助 Model Context Protocol (MCP) 開發。它提供了豐富功能，能幫助用戶輕鬆處理日期、時間、時區轉換以及天文計算等任務。

🚀 快速開始

TimezoneToolkit 能讓你便捷地進行時間和時區相關操作。你可以獲取不同時區的當前時間、計算日出日落時間、進行時區轉換等。

✨ 主要特性

• 多時區支持：內置全球主要時區信息
• 日期時間操作：包括時間加減、格式化等功能
• 天文計算：日出日落、潮汐等自然現象計算
• JSON RPC 支持：通過 MCP 協議與 Claude Desktop 集成

📦 安裝指南

先決條件

• Node.js 18.x 或更高版本
• npm 9.x 或更高版本
• 最新版的 Claude Desktop

安裝步驟

# 下載項目源碼
git clone https://github.com/yourusername/timezone-toolkit.git

# 進入項目目錄
cd timezone-toolkit

# 安裝依賴項
npm install

# 啟動 MCP 服務器
node dist/index.js

💻 使用示例

基礎用法

# 獲取當前時間，默認使用 UTC 時區
npm start -- --timeZone=UTC

# 轉換為紐約時間
npm start -- --convertTo=America/New_York

📚 詳細文檔

功能模塊

1. 時間顯示

獲取當前時間

{
  "currentTime": "2024年3月25日，晚上9:54",
  "timezone": "美洲/紐約",
  "utcOffset": "-04:00"
}

示例命令

• getCurrentTime：獲取指定時區的當前時間
• listTimezones：列出所有可用時區

2. 日出日落計算

方法調用示例

{
  "latitude": 37.7749,
  "longitude": -122.4194,
  "date": "2024-03-25",
  "time": "06:00"
}

返回結果

{
  "sunrise": "早上6:05",
  "sunset": "晚上7:15",
  "moonPhase": "漸虧 gibbous"
}

3. 時區轉換

支持的操作包括：

• 時間加減小時/分鐘
• 轉換為 UTC 時間
• 顯示時區偏移量（如 +08:00）

🔧 技術細節

核心組件

• 核心服務：處理時區轉換、天文計算和日期格式化
• MCP 服務器：接收來自 Claude Desktop 的 JSON RPC 請求
• 工具函數：提供日期時間操作的輔助功能
• 測試框架：全面測試 MCP 服務器的功能

技術依賴

• Luxon - 處理所有日期/時間操作和時區管理
• SunCalc - 用於日出、日落等天文計算
• @modelcontextprotocol/sdk - 用於 MCP 服務器實現

🤝 貢獻指南

歡迎貢獻！請按照以下步驟提交代碼：

1. 叉取倉庫
2. 創建功能分支（例如 feature/amazing-feature）
3. 提交更改（例如 git commit -m '添加精彩功能'）
4. 推送到分支（例如 git push origin feature/amazing-feature）
5. 提交拉取請求

🧪 測試方法

基本測試命令

# 執行單元測試
npm test

# 運行端到端測試
npm run e2e

詳細說明

• 測試覆蓋率：確保達到要求的覆蓋範圍
• 集成測試：驗證各模塊協同工作
• 性能測試：評估處理速度和穩定性

⚠️ 故障排除

常見問題及解決方案：

1. 安裝依賴失敗

• 檢查網絡連接
• 確認 Node.js 版本符合要求
• 重新運行 npm install

2. 啟動服務器報錯

• 查看錯誤日誌
• 確保所有依賴已正確安裝

3. 無法與 Claude 集成

• 檢查 MCP 協議版本
• 確認端口配置正確

🔒 隱私安全

• 數據保護：遵循 GDPR 和 CCPA 規定
• 代碼審計：定期進行安全審查
• 用戶隱私：嚴格保護用戶數據不被濫用

📄 許可證

Apache 2.0 許可證

...

📞 聯繫方式

如有任何問題或建議，請聯繫：

• 郵箱: support@timezone-toolkit.com
• GitHub: https://github.com/timezone-toolkit