Calendar MCP

🚀 谷歌日历自動認証MCPサーバー

このプロジェクトは、Googleカレンダーの自動管理を行うMCP（機械学習制御プロトコル）サーバーです。カレンダーイベントの作成、更新、削除、照会などの機能をサポートしています。自動認証機能を搭載し、Google Calendar APIとのやり取りを簡素化しています。

✨ 主な機能

• 自動認証：ユーザーは簡単な認証を通じて長期アクセストークンを取得でき、OAuthフローを手動で処理する必要がありません。
• 高可用性：効率的なAPI設計と信頼性の高いネットワーク通信メカニズムを採用し、サービスの安定稼働を保証します。
• 拡張性：マルチスレッド処理をサポートし、複数ユーザーのカレンダー要求を同時に処理できます。

📦 インストール

依存関係のインストール

1. システムにPython 3.6以上がインストールされていることを確認してください。
2. 必要なPythonライブラリをインストールします。

   pip install google-api-python-client oauth2client flask
   

設定手順

1. プロジェクトコードをダウンロードし、指定のディレクトリに解凍します。
2. 環境変数を設定します。
   • GC_CREDENTIALSをOAuth認証情報ファイルのパスに設定します。
   • GC_PROJECT_IDを対象プロジェクトのGoogle CloudプロジェクトIDに設定します。

💻 使用例

基本的な使用法

イベント管理

イベントの作成

JSON形式で詳細情報（タイトル、時間、場所など）を渡すことができます。

{
    "summary": "会議",
    "start_time": "2024-05-15T14:00:00",
    "end_time": "2024-05-15T16:00:00"
}

イベントの更新

イベントIDを指定して変更する項目を指定し、新しい詳細情報を提供します。

イベントの削除

イベントIDを使用してカレンダーから特定の項目を直接削除します。

カレンダー同期

一括インポート

複数のイベントを一度にインポートでき、データ移行の効率を向上させます。

差分更新

変更された部分のみを同期するため、ネットワークトラフィックとサーバー負荷を削減します。

高度な使用法

# 新しいイベントを作成する
curl -X POST \
     http://localhost:5000/api/events \
     -H "Content-Type: application/json" \
     -d '{"summary":"プロジェクト会議","start_time":"2024-05-16T10:00:00","end_time":"2024-05-16T11:30:00"}'

# 特定のイベントを照会する
curl -X GET \
     http://localhost:5000/api/events/abc123xyz456

🔧 技術詳細

セキュリティメカニズム

• 認証情報の暗号化：すべてのOAuth認証情報はAES暗号化で処理され、安全に保存されます。
• アクセス制御：ロールベースの権限管理を行い、不正アクセスを防止します。
• 監査ログ：すべてのAPI呼び出し履歴を記録し、後の追跡と分析に役立てます。

📚 ドキュメント

よくある質問

1. 認証期限が切れた場合、どうすればいいですか？
   • サーバーが自動的にトークンの有効期限を検出し、期限切れになると自動的に更新します。
2. 複数のカレンダーアカウントをサポートしていますか？
   • はい、各ユーザーには独立したカレンダーストレージがあり、データの分離が保証されます。
3. 照会効率を向上させるにはどうすればいいですか？
   • フィルタパラメータ（時間範囲、イベントラベルなど）を使用すると、照会速度を大幅に向上させることができます。

その他のドキュメント

• 詳細なインターフェイス定義については、APIドキュメントを参照してください。
• サンプルコードと使用チュートリアルについては、Wikiページを参照してください。

🤝 貢献とサポート

Pull Requestの提出や問題の報告を歓迎します。商用サポートが必要な場合は、プロジェクトのメンテナにご連絡ください。

当社のGoogleカレンダー自動認証MCPサーバーを選んでいただき、ありがとうございます。ご意見やご提案をお待ちしています！