Headless Gmail

🚀 無頭 Gmail MCP 服務器

MCP 無頭 Gmail 服務器是一個基於 Google API 的服務，可通過命令行或其他自動化工具與 Gmail 賬戶交互，支持讀取郵件、獲取郵件正文內容以及發送新郵件等功能。

🚀 快速開始

MCP 無頭 Gmail 服務器能讓你通過命令行或自動化工具輕鬆與 Gmail 賬戶交互。按照以下步驟，你可以快速搭建並使用該服務。

✨ 主要特性

• 完全自動化：無需手動操作，可通過腳本或命令行調用。
• 高效性能：優化了 API 調用流程，處理大量郵件時效率高。
• 安全設計：採用令牌認證機制，支持 OAuth 2.0 協議，確保數據傳輸安全。
• 擴展性好：易於與其他系統集成，可快速添加更多 Gmail 相關功能。

📦 安裝指南

先決條件

1. 註冊 Google Cloud 賬戶並創建項目。
2. 啟用 Gmail API。
3. 配置 OAuth 一致性屏幕。
4. 創建 OAuth 客戶端 ID（選擇桌面應用類型）。
5. 獲取訪問令牌和刷新令牌，所需作用域包括：
   • https://www.googleapis.com/auth/gmail.readonly（用於讀取郵件）
   • https://www.googleapis.com/auth/gmail.send（用於發送郵件）

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/yourusername/mcp-headless-gmail.git
   cd mcp-headless-gmail
   

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 配置環境變量，設置您的 Google API 憑證：

   export GOOGLE_CLIENT_ID=your_client_id
   export GOOGLE_CLIENT_SECRET=your_client_secret
   export GOOGLE_REFRESH_TOKEN=your_refresh_token
   

4. 啟動服務：

   python3 server.py
   

💻 使用示例

基礎用法

在安裝並啟動服務後，你可以通過以下方式與 Gmail 賬戶進行交互。

讀取郵件

# 這裡可以添加讀取郵件的代碼示例

發送郵件

# 這裡可以添加發送郵件的代碼示例

📚 詳細文檔

Docker 使用

構建鏡像

# 基礎鏡像
FROM python:3.8-slim

# 設置工作目錄
WORKDIR /app

# 安裝依賴
COPY requirements.txt .
RUN pip install -r requirements.txt

# 複製應用代碼
COPY . .

# 環境變量配置
ENV GOOGLE_CLIENT_ID=your_client_id \
    GOOGLE_CLIENT_SECRET=your_client_secret \
    GOOGLE_REFRESH_TOKEN=your_refresh_token

# 啟動命令
CMD ["python3", "server.py"]

運行容器

docker build -t mcp-headless-gmail .
docker run -d --name mcp-email-service mcp-headless-gmail

Claude Desktop 配置

1. 添加以下工具到 Claude.yaml：

   tools:
     - name: gmail_get_recent_emails
       path: /api/gmail/recent
     - name: gmail_get_email_body
       path: /api/gmail/body
     - name: gmail_send_email
       path: /api/gmail/send
     - name: gmail_refresh_token
       path: /api/gmail/refresh-token
   

2. 在 Claude 中使用這些工具：

   {
     "tool": "gmail_get_recent_emails",
     "args": {
       "access_token": "${GOOGLE_ACCESS_TOKEN}"
     }
   }
   

跨平臺發佈

1. 生成多平臺鏡像：

   docker buildx build --platform linux/amd64,linux/arm64 -t mcp-headless-gmail:multi .
   

2. 推送鏡像到 Docker Hub 或其他 registry。

🔧 技術細節

功能

• 讀取郵件：獲取收件箱中的郵件列表、郵件內容及詳細信息。
• 獲取郵件正文：支持分塊讀取大尺寸郵件的正文內容。
• 發送郵件：通過 API 發送新的郵件，支持 HTML 格式和純文本格式。

⚠️ 重要提示

• 始終使用 HTTPS 傳輸數據。
• 不要將憑證提交到公開代碼庫。
• 定期輪換訪問令牌，確保安全。

📄 許可證

詳見 LICENSE 文件。