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"）。

返回：

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