🚀 Gmail-MCP-Server
Gmail-MCP-Server 是一个借助 fastMCP 构建的高弹性 MCP 服务器，可通过 Gmail 的 SMTP 服务器发送电子邮件，还能利用 AI 代理处理文件附件。
🚀 快速开始
此仓库包含一个使用 fastMCP 构建的有弹性的 MCP 实现。该服务器旨在通过 Gmail 的 SMTP 服务器发送电子邮件，并支持以下几种方法来附加文件：
- 直接文件路径：可附加本地文件系统中存在的文件。
- 基于 URL 的附件：能下载来自指定 URL 的文件并进行附件处理。
- 预存附件：可使用存储在特定目录中的附件。
该服务器的设计注重弹性，具备增加的超时设置和优雅的关闭处理机制。
✨ 主要特性
- Gmail SMTP 集成：使用 Gmail 的 SMTP 服务器通过 TLS 发送电子邮件。（请确保已在您的账户上设置了 Gmail SMTP 并生成应用程序密码）
- 多种附件方法：
- 可直接从文件路径附加文件。
- 能下载来自公共 URL 的文件进行处理。
- 可使用预存的本地存储附件。
- 弹性设计：增加超时设置和信号处理，实现优雅关闭。
- 基于环境变量的配置：使用环境变量安全地管理 Gmail 资格凭证。
📦 安装指南
先决条件
- Python 3.x
- fastMCP（通过
pip install mcp安装） - python-dotenv（通过
pip install python-dotenv安装） - requests（通过
pip install requests安装）
安装步骤
- 克隆仓库
git clone <远程仓库 URL> cd gmail-mcp-server - 设置环境变量
创建根目录下的
.env文件，并添加您的 Gmail SMTP 资格凭证：
SMTP_USERNAME=your.email@gmail.com
SMTP_PASSWORD=your_app_password
⚠️ 重要提示
如果您在 Gmail 账户上启用了两步验证，必须生成并使用应用程序密码。
- OPEN CLAUDE 配置 OPEN CLAUDE > 设置 > MCP > 配置 > OPEN claude_desktop_config.json > 将文件粘贴到下方路径：
{
"mcpServers": {
"gmail-mcp": {
"command": "python",
"args": ["PATH_TO_gmail-mcp.py"],
"port": 5005
}
}
}
将 PATH_TO_gmail-mcp.py 替换为实际的脚本路径。
- 使用 pip 安装 fastMCP
pip install mcp
- 运行服务器
python your_script_name.py
💻 使用示例
基础用法
1. 直接文件附件
在 Python 脚本中，直接从文件路径附加：
from mcp import Client
client = Client('localhost', 5005)
client.send_email_with_attachment('to@example.com', '主题', '正文', '/path/to/file.txt')
2. 基于 URL 的附件
通过指定的 URL 下载并附加文件：
from mcp import Client
client = Client('localhost', 5005)
client.send_email_with_url_attachment('to@example.com', '主题', '正文', 'http://example.com/file.txt')
3. 预存附件
使用预存的附件进行处理：
from mcp import Client
client = Client('localhost', 5005)
client.send_email_with_pre_attached_file('to@example.com', '主题', '正文', '/path/to/pre_attachment.txt')