Gmail Attachment MCP Server

Gmail Attachment MCP Server

一个提供微服务的服务器，可使用 Message Control Protocol (MCP) 下载 Gmail 附件。

概述

此项目实现了一个 FastMCP 服务器，可让你使用邮件 ID 从 Gmail 邮件中下载附件。它使用 IMAP 连接 Gmail 并获取附件。

功能

• 使用邮件 ID 下载 Gmail 邮件中的附件
• 使用 IMAP over SSL 安全连接 Gmail
• 通过环境变量配置凭据
• 通过 MCP 提供简单的 API 接口

前置条件

• Python 3.7 或更高版本
• 需要安装 uv
• 启用了 IMAP 的 Gmail 帐户
• Gmail 应用专用密码（如果使用两步验证）

安装

# Clone the repository
git clone https://github.com/yourusername/gmail-attachment-mcp-server.git
cd gmail-attachment-mcp-server

# Install dependencies
uv sync

配置

设置以下环境变量：

export GMAIL_USERNAME="[email protected]"
export GMAIL_PASSWORD="your_app_password"
export GMAIL_IMAP_SERVER="imap.gmail.com" # Optional, defaults to imap.gmail.com

注意：对于 Gmail，建议使用应用专用密码，而不是常规密码。更多信息请参阅 Google 的文档。

使用方法

启动服务器

python server.py
# or
mcp run server.py

使用工具

服务器提供了一个 download_attachments_tool，接受以下参数：

• message_id：十六进制格式的 Gmail 邮件 ID
• download_folder：（可选）下载附件的文件夹（默认为 "./attachments"）

此函数会返回已下载附件文件的路径列表。

使用 mcp inspector

npx @modelcontextprotocol/inspector uv run mcp run server.py

使用 goose

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

API 参考

download_attachments_tool

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

下载由邮件 ID 标识的 Gmail 邮件中的附件。

参数：

• message_id：十六进制格式的 Gmail 邮件 ID
• download_folder：（可选）下载附件的文件夹（默认为 "./attachments"）

返回值：

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

许可证

MIT