Gmail MCP 服务器

一个功能强大且灵活的 Gmail 集成服务器，基于 MCP（消息控制协议）框架构建。该服务器提供与 Gmail API 交互的强大接口，支持邮件的读取、发送和管理。

特性

• 多个 Gmail 账户读取邮件
• 支持附件的邮件发送
• 具备高级搜索选项的邮件搜索
• 邮件附件下载功能
• 管理邮件对话和线程
• 实时邮件监控
• 支持多个 Gmail 账户

prerequisites

运行 Gmail MCP 服务器之前，请确保以下条件已满足：

1. Python 3.12 或更高版本
2. 启用 Gmail API 的 Google Cloud 项目
3. OAuth 2.0 客户端 ID 凭证
4. 所需的 Python 包（在 pyproject.toml 中指定）

安装

通过 Smithery 安装

使用 Smithery 自动安装 Gmail 集成服务器：

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

1. 克隆仓库：

git clone <your-repository-url>
cd gmail-mcp-server

2. 创建并激活虚拟环境：

python -m venv venv
# Windows 系统
venv\Scripts\activate
# Unix/MacOS 系统
source venv/bin/activate

3. 安装依赖项：

pip install .

配置 Google Cloud 项目

1. 访问 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用项目的 Gmail API
4. 创建 OAuth 2.0 凭证：
   • 转到 "APIs & Services" > "Credentials"
   • 点击 "Create Credentials" > "OAuth client ID"
   • 选择 "Desktop app" 作为应用类型
   • 下载客户端配置文件
5. 将下载的文件重命名为 client_secret.json 并放在项目根目录中

配置

1. 在 gmail_token_creator.py 中设置电子邮件标识符：

email_identifier = 'your.email@gmail.com'  # 根据需要修改

2. 运行令牌创建工具以验证您的 Gmail 账户：

python gmail_token_creator.py

3. 对于每个要集成的 Gmail 账户，重复上述步骤

服务器结构

• gmail_server.py：主要 MCP 服务器实现
• gmail_api.py：Gmail API 交互函数
• google_apis.py：Google API 认证工具
• 支持文件：
  • read_emails.py：邮件读取功能
  • search_emails.py：邮件搜索功能
  • send_emails.py：邮件发送功能

使用方法

启动服务器

python gmail_server.py

可用工具

1. 发送邮件：

await send_gmail(
    email_identifier="your.email@gmail.com",
    to="recipient@example.com",
    subject="Test Subject",
    body="Email body content",
    attachment_paths=["path/to/attachment"]
)

2. 搜索邮件：

async def process_email(email):
    # 处理找到的邮件
    pass

await search_emails(
    email_identifier="your.email@gmail.com",
    query="subject:important",
    callback=process_email
)

3. 下载附件：

async def download_attachment(attachment):
    # 处理下载的附件
    pass

await get_attachments(
    email_identifier="your.email@gmail.com",
    message_id="message-id-12345",
    attachments_callback=download_attachment
)

安全注意事项

• 确保 client_secret.json 文件的安全性，避免泄露
• 使用环境变量存储敏感信息（如电子邮件密码）
• 定期更新 OAuth 令牌以增强安全性

其他资源

• Gmail API 文档
• Python Gmail 示例代码

通过以上步骤，您可以轻松设置并使用 Gmail MCP 服务器来管理您的邮件和附件。