Py MCP Gcalendar

🚀 Google Calendar MCP 服務器 - Python 安裝指南

本項目是一個提供對 Google 日曆 API 訪問的模型上下文協議（Model Context Protocol）服務器，支持異步操作。通過標準化接口，實現了高效的日曆管理。

✨ 主要特性

API 工具

• 列表：可查詢過去兩年到未來一年的日曆事件。
• 創建活動：能夠創建新的日曆條目。
• 刪除重複項：可移除重複的事件。
• 刪除活動：可以刪除特定的日曆事件。

核心資源

• 令牌管理系統（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 憑據。
• 上網連接。
• 時區設置為亞洲/曼谷。

🔧 技術細節

服務器配置

在 claude_desktop_config.json 中添加服務器配置信息，以確保服務器能夠正確啟動和運行。

路徑配置

根據不同的操作系統和環境，替換相應的佔位符，保證路徑的正確性。

錯誤處理

通過自動令牌刷新、操作超時設置、全面錯誤記錄和瞬態錯誤自動重試等機制，提高系統的穩定性和可靠性。

📄 許可證

該項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。