Gmail 附件 MCP 服务器

一个提供微服务的服务器，用于通过消息控制协议 (MCP) 下载 Gmail 附件。

概述

该项目实现了一个 FastMCP 服务器，允许您使用消息 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

API 参考

download_attachments_tool

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

从 Gmail 信息中下载附件，该信息由其消息 ID 标识。

参数：

• message_id: Gmail 信息 ID，十六进制格式
• download_folder: (可选) 下载到的文件夹路径（默认为 "./attachments"）

返回：

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