Gmail Attachment MCP Server

🚀 Gmail 附件 MCP 服務器

本項目是一個提供微服務的服務器，藉助消息控制協議 (MCP) 實現 Gmail 附件的下載功能，為用戶獲取 Gmail 附件提供了便捷途徑。

🚀 快速開始

本服務器允許您使用消息 ID 下載 Gmail 信息中的附件。它藉助 IMAP 連接到 Gmail 並獲取附件。

✨ 主要特性

• 可使用消息 ID 下載 Gmail 信息中的附件。
• 運用 SSL 實現與 Gmail 的 IMAP 安全連接。
• 支持通過環境變量配置身份驗證憑據。
• 提供基於 MCP 的簡單 API 接口。

📦 安裝指南

先決條件

• Python 3.7 或更高版本。
• 已安裝 uv。
• 啟用 IMAP 的 Gmail 賬戶。
• 若使用兩步驗證，需準備 Gmail 應用密碼。

安裝步驟

# 克隆倉庫
git clone https://github.com/yourusername/gmail-attachment-mcp-server.git
cd gmail-attachment-mcp-server

# 安裝依賴項
uv 同步

⚙️ 配置說明

需設置以下環境變量：

export GMAIL_USERNAME="your.email@gmail.com"
export GMAIL_PASSWORD="your_app_password"
export GMAIL_IMAP_SERVER="imap.gmail.com" # 可選，默認為 imap.gmail.com

⚠️ 重要提示

對於 Gmail，應該使用應用密碼而不是常規密碼。請參閱 Google 的文檔 瞭解更多信息。

💻 使用示例

啟動服務器

python server.py
# 或者
mcp 運行 server.py

使用工具

該服務器公開了一個 download_attachments_tool，接受以下參數：

• message_id: Gmail 信息 ID，十六進制格式。
• download_folder: (可選) 下載到的文件夾路徑（默認為 "./attachments"）。

該函數返回一個包含下載附件文件路徑的字符串列表。

使用 mcp 檢查工具

npx @modelcontextprotocol/inspector uv 運行 mcp 運行 server.py

使用鵝 (geese)

extensions:
  gmail-attachment-mcp-server:
    args:
      - run
      - /path to virtual env/.venv/bin/mcp
      - run
      - /path to gmail-attachment-mcp-server/server.py
    bundled: null
    cmd: uv
    description: null
    enabled: true
    env_keys:
      - GMAIL_USERNAME
      - GMAIL_PASSWORD
    envs: {}
    name: gmail-attachment-mcp-server
    timeout: 300
    type: stdio

📚 詳細文檔

download_attachments_tool

download_attachments_tool(message_id: str, download_folder="./attachments") -> list[str]

從 Gmail 信息中下載附件，該信息由其消息 ID 標識。

參數：

• message_id: Gmail 信息 ID，十六進制格式。
• download_folder: (可選) 下載到的文件夾路徑（默認為 "./attachments"）。

返回：

• 包含已下載附件文件路徑字符串的列表。