Gmail-mcp-server

Gmail-mcp-server

site icon
2025.03.29 3
Python电子邮件服务SMTP 集成交流协作
Gmail-mcp-server 是一个基于 fastMCP 构建的弹性 MCP 服务器,专门用于通过 Gmail 的 SMTP 服务器发送电子邮件。该服务器支持多种附件添加方式,包括直接文件路径、URL 下载附件以及预存附件。服务器设计注重弹性,具有增加的超时时间和优雅的关闭处理。
View on GitHub

Overview

基本能力

产品定位

Gmail-mcp-server 是一个用于通过 Gmail SMTP 服务器发送电子邮件的 MCP 服务器,支持多种附件添加方式。

核心功能

  • Gmail SMTP 集成:使用 Gmail 的 SMTP 服务器和 TLS 发送电子邮件。
  • 多种附件方法
  • 直接从文件路径添加附件。
  • 从公共 URL 下载并添加附件。
  • 使用本地预存的附件。
  • 弹性设计:增加超时时间和信号处理以实现优雅关闭。
  • 基于环境的配置:使用环境变量安全管理 Gmail 凭据。

适用场景

  • 需要通过 Gmail 发送电子邮件的自动化流程。
  • 需要附加不同来源文件的电子邮件发送任务。
  • 需要高可靠性和弹性的电子邮件发送服务。

工具列表

  • send_email_tool:用于发送电子邮件,支持多种附件添加方式。

常见问题解答

  • 确保已设置 Gmail SMTP 并生成应用密码。
  • 如果使用两步验证,必须生成并使用应用密码。

使用教程

使用依赖

安装以下依赖:

pip install mcp python-dotenv requests

安装教程

  1. 克隆仓库:
git clone <remote-repository-URL>
cd gmail-mcp-server
  1. 设置环境变量: 创建 .env 文件并添加:
[email protected]
SMTP_PASSWORD=your_app_password
  1. 可选:准备附件目录: 在根目录创建 available_attachments 目录。

调试方式

启动服务器:

python server.py

服务器将在 127.0.0.1:5000 上启动。

通过 Smithery 安装:

npx -y @smithery/cli install @MaitreyaM/gmail-mcp-server --client claude

许可证

该项目遵循 MIT 开源许可条款。