Epaproditus Google Workspace MCP Server

🚀 Google 工作區 MCP 服務器

這是一個基於 Model Context Protocol (MCP) 的服務器，它提供了與 Gmail 和日曆 API 交互的工具。藉助 MCP 接口，你能夠對電子郵件和日曆事件進行編程管理，極大提升工作效率。

🚀 快速開始

本服務器可讓你輕鬆通過 MCP 接口對 Gmail 郵件和日曆事件進行編程管理。在使用前，請確保完成以下先決條件和設置步驟。

✨ 主要特性

Gmail 工具

• list_emails：列出收件箱中的近期郵件，還具備可選過濾功能。
• search_emails：支持使用 Gmail 查詢語法進行高級郵件搜索。
• send_email：可發送新郵件，並且支持 CC 和 BCC。
• modify_email：能修改電子郵件標籤，如存檔、移動到垃圾郵件、標記為已讀/未讀。

日曆工具

• list_events：列出未來範圍內的日曆活動，帶有日期篩選功能。
• create_event：可創建新日曆事件，支持添加與會者。
• update_event：用於更新現有日曆事件。
• delete_event：可刪除日曆事件。

📦 安裝指南

先決條件

1. Node.js：確保已安裝 Node.js（推薦版本 14 或更高）。
2. Google Cloud Console 設置：
   • 創建項目並啟用 Google Workspace API 和 Calendar API。
   • 配置 OAuth 2.0 憑證，授予以下作用域： https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/calendar

設置步驟

1. 克隆代碼倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 創建憑證文件：
   • 在 Google Cloud Console 中創建 credentials.json 文件，內容示例如下：

   {
       "type": "service_account",
       "project_id": "your-project-id",
       "private_key_id": "your-private-key-id",
       "client_email": "your-service-account@your-project-id.iam.gserviceaccount.com",
       "private_key": "your-private-key",
       "client_id": "your-client-id",
       "auth_uri": "https://accounts.google.com/o/oauth2/auth",
       "token_uri": "https://oauth2.googleapis.com/token",
       "AuthProviderLink": "https://www.googleapis.com/auth/",
       "Authority": "https://accounts.google.com/o/oauth2/auth"
   }
   

4. 獲取刷新令牌：

   npm run get-refresh-token
   

配置 MCP 設置

1. 根據以下路徑配置不同 IDE 的 MCP 設置：
   • VS Code：~/.config/google/workspace-mcp/setting.json
   • IntelliJ IDEA：File > Settings > Google Workspace MCP Config
   • PyCharm：File > Settings > Google Workspace MCP Config
2. 示例配置內容如下：

   {
       "gmail": {
           "apiKey": "your-gmail-api-key",
           "refreshToken": "your-refresh-token"
       },
       "calendar": {
           "apiKey": "your-calendar-api-key",
           "refreshToken": "your-refresh-token"
       }
   }
   

構建與運行

npm run build
npm start

💻 使用示例

基礎用法

Gmail 示例

1. 列出郵件：

   {
       "command": "list_emails",
       "maxResults": 10,
       "q": "subject:meeting"
   }
   

2. 發送郵件：

   {
       "command": "send_email",
       "to": "recipient@example.com",
       "subject": "測試郵件",
       "body": "這是測試郵件內容。"
   }
   

日曆示例

1. 創建事件：

   {
       "command": "create_event",
       "summary": "團隊會議",
       "location": "會議室",
       "description": "每週同步",
       "start": "2024-01-24T10:00:00Z",
       "end": "2024-01-24T11:00:00Z",
       "attendees": ["colleague@example.com"]
   }
   

📚 詳細文檔

故障排除

身份驗證問題

• 確保所有必需的 OAuth 作用域已授權。
• 驗證客戶 ID 和密鑰是否正確。
• 檢查刷新令牌的有效性。

API 錯誤

• 查看 Google Cloud Console 中的 API 配額和限制。
• 確保 APIs 已為你的項目啟用。
• 驗證請求參數是否符合要求格式。

📄 許可證

此項目遵循 MIT 許可證。