Quantum 369 Gmail MCP Server

🚀 Gmail MCP 服務器

Gmail MCP 服務器是一個功能強大且靈活的 Gmail 集成服務器，基於 MCP（消息控制協議）框架構建。它提供了與 Gmail API 交互的強大接口，支持郵件的讀取、發送和管理，能極大地提升郵件處理效率。

✨ 主要特性

• 🔍 支持從多個 Gmail 賬戶讀取郵件
• 📎 支持發送帶有附件的郵件
• 🔎 具備高級搜索選項，可精準搜索郵件
• 💾 支持郵件附件下載功能
• 💬 可管理郵件對話和線程
• 🕒 提供即時郵件監控功能
• 👥 支持多個 Gmail 賬戶同時使用

📦 安裝指南

通過 Smithery 安裝

使用 Smithery 可自動安裝 Gmail 集成服務器：

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

手動安裝

1. 克隆倉庫：

git clone <your-repository-url>
cd gmail-mcp-server

2. 創建並激活虛擬環境：

python -m venv venv
# Windows 系統
venv\Scripts\activate
# Unix/MacOS 系統
source venv/bin/activate

3. 安裝依賴項：

pip install .

📚 詳細文檔

運行前的先決條件

運行 Gmail MCP 服務器之前，請確保以下條件已滿足：

1. Python 3.12 或更高版本
2. 啟用 Gmail API 的 Google Cloud 項目
3. OAuth 2.0 客戶端 ID 憑證
4. 所需的 Python 包（在 pyproject.toml 中指定）

配置 Google Cloud 項目

1. 訪問 Google Cloud Console
2. 創建新項目或選擇現有項目
3. 啟用項目的 Gmail API
4. 創建 OAuth 2.0 憑證：
   • 轉到 "APIs & Services" > "Credentials"
   • 點擊 "Create Credentials" > "OAuth client ID"
   • 選擇 "Desktop app" 作為應用類型
   • 下載客戶端配置文件
5. 將下載的文件重命名為 client_secret.json 並放在項目根目錄中

配置

1. 在 gmail_token_creator.py 中設置電子郵件標識符：

email_identifier = 'your.email@gmail.com'  # 根據需要修改

2. 運行令牌創建工具以驗證您的 Gmail 賬戶：

python gmail_token_creator.py

3. 對於每個要集成的 Gmail 賬戶，重複上述步驟

服務器結構

• gmail_server.py：主要 MCP 服務器實現
• gmail_api.py：Gmail API 交互函數
• google_apis.py：Google API 認證工具
• 支持文件：
  • read_emails.py：郵件讀取功能
  • search_emails.py：郵件搜索功能
  • send_emails.py：郵件發送功能

💻 使用示例

啟動服務器

python gmail_server.py

發送郵件

await send_gmail(
    email_identifier="your.email@gmail.com",
    to="recipient@example.com",
    subject="Test Subject",
    body="Email body content",
    attachment_paths=["path/to/attachment"]
)

搜索郵件

async def process_email(email):
    # 處理找到的郵件
    pass

await search_emails(
    email_identifier="your.email@gmail.com",
    query="subject:important",
    callback=process_email
)

下載附件

async def download_attachment(attachment):
    # 處理下載的附件
    pass

await get_attachments(
    email_identifier="your.email@gmail.com",
    message_id="message-id-12345",
    attachments_callback=download_attachment
)

⚠️ 重要提示

• 確保 client_secret.json 文件的安全性，避免洩露。
• 使用環境變量存儲敏感信息（如電子郵件密碼）。
• 定期更新 OAuth 令牌以增強安全性。

📖 其他資源

• Gmail API 文檔
• Python Gmail 示例代碼

通過以上步驟，您可以輕鬆設置並使用 Gmail MCP 服務器來管理您的郵件和附件。