Py MCP Gcalendar

🚀 Google Calendar MCP サーバ - Python インストールガイド

Google カレンダー API へのアクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバで、非同期操作もサポートしています。この実装は標準化されたインターフェースを通じて、効率的なカレンダー管理を実現しています。

✨ 主な機能

API ツール

• リスト：カレンダーイベントをクエリします（過去 2 年から未来 1 年まで）
• 活動の作成：新しいカレンダーエントリを作成します
• 重複の削除：重複するイベントを削除します
• 活動の削除：特定のカレンダーイベントを削除します

核心リソース

• トークン管理システム（credentials/*.json）
  • OAuth 2.0 認証フロー
  • 自動トークンリフレッシュ処理
  • ランタイムトークン検出
• 記録システム（logs/*.log）
  • 操作記録（タイムスタンプ付き）
  • エラートラッキングとデバッグ
  • パフォーマンス指標の収集

📦 インストール

前提条件

# 必要な Python パッケージをインストールします
pip install -r requirements.txt

依存関係：

google-auth-oauthlib==1.0.0
google-auth-httplib2==0.1.0
google-api-python-client==2.108.0
aiohttp==3.8.5
asyncio==3.4.3

初期設定

# リポジトリをクローンします
git clone https://github.com/yourusername/GCalendar.git
cd GCalendar

# 必要なディレクトリを作成します
mkdir -p credentials logs

認証設定

1. Google Cloud Console でプロジェクトを作成します
2. Google カレンダー API を有効にします
3. credentials.json を credentials/ ディレクトリにダウンロードします
4. create_token.py を実行します：

python src/create_token.py

🔧 技術詳細

サーバー設定

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "gcalendar": {
      "command": "YOUR_CONDA_PATH/envs/mcp-gcalendar/bin/python",
      "args": [
        "YOUR_PATH/GCalendar/src/mcp_server.py"
      ]
    }
  }
}

パス設定

プレースホルダーを置き換えます：

• YOUR_CONDA_PATH オプション：
  • M1/M2 Mac: /opt/homebrew/Caskroom/miniforge/base
  • Miniconda: ~/miniconda3 または /opt/miniconda3
• YOUR_PATH：リポジトリの完全なクローンパス

エラー処理

• 自動トークンリフレッシュ（期限切れ時）
• 60 秒の操作タイムアウト
• 完全なエラー記録
• 一時的なエラーの自動再試行

プロジェクト構造

GCalendar/
├── credentials/
│   ├── credentials.json   # Google Cloud Console からのファイル
│   └── token.json        # create_token.py によって生成されたファイル
├── logs/
│   └── calendar_service.log
├── src/
│   ├── calendar_service.py   # 核心カレンダー操作
│   ├── create_token.py      # トークン生成
│   ├── list_past_events.py  # 活動リストツール
│   ├── mcp_client.py        # MCP クライアントの実装
│   ├── mcp_server.py        # メインサーバーの実装
│   └── renew_token.py       # トークン更新ツール
├── requirements.txt
└── README.md

システム要件

• Python 3.9 またはそれ以上
• Google カレンダー API が有効になっている
• 有効な OAuth 2.0 資格情報
• インターネット接続
• タイムゾーンがアジア/バンコクに設定されている

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。