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