Calendar MCP

🚀 谷歌日曆自動授權MCP服務器

這是一個用於自動化管理Google日曆的MCP（機器學習控制協議）服務器，支持創建、更新、刪除和查詢日曆事件等功能。該服務器集成了自動授權功能，簡化了與Google Calendar API的交互流程。

🚀 快速開始

本服務器是用於自動化管理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。

💻 使用示例

基礎用法

# 創建新事件
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

高級用法

# 創建事件，支持通過JSON格式傳遞詳細信息，包括標題、時間、地點等
{
    "summary": "會議",
    "start_time": "2024-05-15T14:00:00",
    "end_time": "2024-05-15T16:00:00"
}

📚 詳細文檔

功能模塊

事件管理

• 創建事件：支持通過JSON格式傳遞詳細信息，包括標題、時間、地點等。
• 更新事件：通過事件ID指定要修改的條目，並提供新的詳細信息。
• 刪除事件：使用事件ID直接從日曆中移除特定條目。

日曆同步

• 批量導入：支持一次性導入多個事件，提升數據遷移效率。
• 增量更新：僅同步變更的部分，減少網絡傳輸量和服務器負載。

安全機制

• 憑證加密：所有OAuth憑證均經過AES加密處理，確保存儲安全。
• 訪問控制：基於角色的權限管理，防止未授權操作。
• 審計日誌：記錄所有API調用歷史，便於後續追蹤和分析。

項目文檔

• 詳細接口定義請參考API文檔。
• 示例代碼和使用教程可訪問Wiki頁面。

🔧 技術細節

本服務器採用高效的API設計和可靠的網絡通信機制，支持多線程處理，能同時處理多個用戶的日曆請求。所有OAuth憑證均經過AES加密處理，採用基於角色的權限管理防止未授權操作，並記錄所有API調用歷史便於追蹤和分析。

🤝 貢獻與支持

歡迎提交Pull Request或報告問題。如需商業支持，請聯繫項目維護者。

感謝您選擇我們的Google日曆自動授權MCP服務器，期待您的反饋和建議！