Jmonsellier Gmail MCP Server

🚀 Gmail 服務器用於模型上下文協議 (MCP)

本 MCP 服務器與 Gmail 集成，可實現發送、刪除、閱讀、撰寫和回覆電子郵件等功能。它為用戶提供了便捷的郵件操作途徑，讓郵件管理更加高效。

⚠️ 重要提示

此服務器允許 MCP 客戶端讀取、刪除和發送電子郵件。不過，客戶端在執行此類操作前會提示用戶。

GitHub 資源鏈接

✨ 主要特性

• 與 Gmail 深度集成，支持多種郵件操作。
• 客戶端操作前會提示用戶，保障用戶信息安全。

📦 安裝指南

Gmail API 配置

1. 創建一個新的 Google Cloud 項目
2. 啟用 Gmail API
3. 配置 OAuth 同意屏幕
   • 選擇“外部”。不過，我們不會發布此應用程序。
   • 將您的個人電子郵件地址添加為“測試用戶”。
4. 添加 OAuth 範圍 https://www.googleapis.com/auth/gmail/modify
5. 創建一個 OAuth 客戶端 ID 對於應用程序類型“桌面應用”
6. 下載您的客戶 OAuth 令牌文件的 JSON 文件
7. 重命名該密鑰文件並保存到您本地計算機的安全位置。請記住此路徑。
   • 啟動服務器時，--creds-file-path 參數將傳遞此文件的絕對路徑。

身份驗證

啟動服務器時，身份驗證流程將在您的系統瀏覽器中啟動。令牌憑證隨後會保存在指定的文件路徑中（並稍後從中檢索），路徑通過 --token-path 參數傳遞。

例如，您可能會使用主目錄中的隱藏目錄：

💻 使用示例

基礎用法

# 示例代碼：啟動 MCP 服務器的命令
python3 mcp_server.py --creds-file-path=/path/to/client_creds.json --token-path=/path/to/app_tokens.json

此服務器將允許與 Gmail 集成，並通過 MCP 協議進行交互。

📚 詳細文檔

組件

工具

• send-email

  • 功能：向指定的收件人發送電子郵件
  • 輸入：
    • recipient_id (字符串)：收件人的電子郵件地址
    • subject (字符串)：電子郵件主題
    • message (字符串)：電子郵件內容
  • 返回：狀態和消息 ID

• trash-email

  • 功能：將電子郵件移動到垃圾郵件文件夾
  • 輸入：
    • email_id (字符串)：自動生成的電子郵件 ID
  • 返回：成功消息

• mark-email-as-read

  • 功能：標記電子郵件為已讀狀態
  • 輸入：
    • email_id (字符串)：自動生成的電子郵件 ID
  • 返回：成功消息

• get-unread-emails

  • 功能：檢索未讀電子郵件
  • 返回：未讀電子郵件的列表，包括電子郵件 ID

• read-email

  • 功能：檢索指定電子郵件的內容
  • 輸入：
    • email_id (字符串)：自動生成的電子郵件 ID
  • 返回：包含電子郵件元數據的字典，並將電子郵件標記為已讀

• open-email

  • 功能：在瀏覽器中打開電子郵件
  • 輸入：
    • email_id (字符串)：自動生成的電子郵件 ID
  • 返回：成功消息並打開指定電子郵件以在默認瀏覽器中查看