Google Workspace MCP

🚀 Google Workspace MCP 說明文檔

Google Workspace MCP（管理控制檯插件）是一款用於統一管理和集成Google Workspace服務的實用工具。它能幫助用戶高效地進行賬戶管理、文件操作、日曆集成和郵件處理等工作，提升使用Google Workspace服務的便捷性和效率。

🚀 快速開始

Google Workspace MCP 能助力你統一管理和集成 Google Workspace 服務。下面為你詳細介紹如何快速開啟使用之旅。

✨ 主要特性

• 賬戶管理：可輕鬆創建、認證和刪除 Google Workspace 賬戶。
• 文件操作：支持文件的上傳、下載、共享以及權限管理。
• 日曆集成：能創建、查詢和訂閱日曆事件。
• 郵件處理：可發送郵件、管理郵件列表並進行過濾設置。

📦 安裝指南

安裝步驟

1. 克隆代碼倉庫：

   git clone https://github.com/your-repository.git
   cd google-workspace-mcp
   

2. 安裝依賴項：

   npm install
   

3. 配置環境變量：
   • 創建並編輯 config/mcp-config.json 文件，填寫以下內容：

     {
       "google": {
         "client_id": "YOUR_GOOGLE_CLIENT_ID",
         "client_secret": "YOUR_GOOGLE_CLIENT_SECRET",
         "redirect_uri": "http://localhost:3000/callback"
       }
     }
     

4. 啟動服務：

   npm start
   

💻 使用示例

基礎用法

賬戶管理

• 認證流程
  1. 執行認證命令：

  ```bash
  authenticate_workspace_account --email your.email@gmail.com
  ```
  

  2. 按照提示完成 OAuth 2.0 認證流程。
• 賬戶列表 顯示所有已認證的賬戶信息：

  list_accounts
  

文件操作

• 上傳文件 上傳本地文件到 Google Drive：

  upload_drive_file --file /path/to/your/file.pdf --parent_folder "Documents"
  

• 下載文件 下載指定文件：

  download_drive_file --id file_id_123456
  

日曆集成

• 創建日曆事件 添加新的日曆活動：

  create_calendar_event --title 會議提醒 --description 項目討論 --start_time "2023-10-01T14:00:00"
  

📚 詳細文檔

詳細使用說明請參考API文檔。

🔧 技術細節

未來計劃

新增服務

• Admin SDK 支持
• 更多 Google 服務集成

測試策略

單元測試方法

1. 簡化模擬
   • 使用靜態 mock 響應以確保測試可預測。
   • 避免在單元測試中進行復雜的端到端模擬。
   • 每次測試一個功能模塊。
   • 對外部依賴（如 OAuth、文件系統）使用簡單實現進行模擬。
2. 測試組織
   • 按照功能將測試分組（例如：賬戶操作、文件操作）。
   • 使用清晰且描述性的測試名稱。
   • 保持測試聚焦且獨立。
   • 在每次測試之間重置 mock 和模塊。
3. Mock 管理
   • 使用 jest.resetModules() 以保證乾淨的狀態。
   • 在 mock 更改後重新需要模塊。
   • 顯式跟蹤 mock 函數調用。
   • 驗證函數調用及其結果。
4. 文件系統測試
   • 使用簡單的 JSON 結構進行測試。
   • 關注數據正確性而非格式。
   • 測試錯誤場景（如缺失文件、無效 JSON）。
   • 驗證文件操作而不涉及具體實現細節。
5. OAuth 模擬
   • 對 OAuth 流程進行充分模擬以避免實際授權過程。
   • 確保測試環境與生產環境隔離。

最佳實踐

安全注意事項

• 憑據管理：建議將 Google OAuth 憑證（client_id 和 client_secret）存放在安全的位置，如加密的配置文件或環境變量中。
• 訪問控制：實施嚴格的權限策略，確保只有授權用戶才能執行敏感操作。

性能優化

• 異步處理：對於大量數據操作，建議使用異步方法以提高效率。
• 錯誤處理：在關鍵操作中添加適當的錯誤捕捉和恢復機制，防止服務中斷。

故障排除

常見問題

1. 認證失敗
   • 確認提供的郵箱地址正確且有效。
   • 檢查 OAuth 憑證是否配置無誤。
2. API 請求超時
   • 驗證網絡連接狀態。
   • 考慮增加請求超時設置或優化數據傳輸量。

附錄

命令行工具參考

• authenticate_workspace_account：用於 Google Workspace 賬戶的 OAuth 認證。
• list_accounts：顯示所有已認證的 Google Workspace 賬戶信息。
• upload_drive_file：上傳文件到指定的 Google Drive 文件夾。
• download_drive_file：下載特定 ID 的 Google Drive 文件。
• create_calendar_event：創建新的日曆事件。

聯繫方式

如需幫助或反饋，請聯繫：

• 郵箱：support@googlworkspace.com
• 電話：+1 (800) 123-4567