📧 Gmail MCP 服务器

一个简单易用的Gmail MCP（模型上下文协议）服务器，允许您通过Cursor直接发送电子邮件！

✨ 特色功能

• 🚀 即插即用：几分钟内完成设置
• 📡 SSE传输：稳定的服务器发送事件协议
• 🔒 安全可靠：使用Google应用密码
• 🌐 可部署：支持本地、内网和云部署
• 🎯 Cursor集成：完美支持Cursor MCP功能

🚀 快速开始

1. 克隆项目

git clone https://github.com/your-username/gmail-mcp.git
cd gmail-mcp

2. 安装依赖

# 创建虚拟环境
python -m venv gmail_mcp_env
source gmail_mcp_env/bin/activate  # macOS/Linux
# 或者 gmail_mcp_env\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

3. 设置Gmail凭证

# 复制环境变量示例
cp env.example .env

# 编辑 .env 文件，填写您的Gmail凭证
# GMAIL_ADDRESS=your-email@gmail.com
# APP_PASSWORD=your-16-digit-app-password

4. 获取Google应用密码

1. 访问Google账户安全设置
2. 启用“两步验证”
3. 访问应用密码设置
4. 选择“邮件”应用程序并生成一个16位数的密码
5. 将密码填写到.env文件中

5. 启动服务器

python gmail_sse_server.py

6. 配置Cursor

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "gmail-mcp": {
      "url": "http://localhost:8000/sse"
    }
  }
}

🛠️ 使用说明

启动服务器后，在Cursor中可以看到三个可用工具：

1. send_email_sse - 发送电子邮件
2. check_server_status - 检查服务器状态
3. get_connection_info - 获取连接信息

发送电子邮件示例

使用工具: send_email_sse
- to_email: recipient@example.com
- subject: 测试邮件
- message: 这是一封来自MCP的测试邮件！
- from_name: 你的名字 (可选)

📁 项目结构

gmail-mcp/
├── 📧 gmail_sse_server.py          # 主服务器
├── 📋 requirements.txt             # Python依赖
├── 📝 README.md                    # 使用说明
├── 📄 env.example                  # 凭证示例
├── 🚫 .gitignore                   # Git忽略文件
├── 📄 PROJECT_STRUCTURE.md         # 项目结构说明
├── 📁 alternatives/                # 其他版本
│   ├── gmail_universal_mcp.py      # 多用户版本
│   └── gmail_secure_mcp.py         # 企业安全版本
└── 📁 docs/                        # 详细文档
    ├── SHARING_GUIDE.md            # 分享指南
    ├── SECURITY_DEPLOYMENT_GUIDE.md # 安全部署指南
    └── requirements-secure.txt     # 安全版本依赖

🔧 高级功能

多用户版本

如果您希望所有团队成员都能使用自己的Gmail凭证：

python alternatives/gmail_universal_mcp.py

企业安全版本

如果需要企业级别的安全特性（HTTPS、认证、加密存储）：

python alternatives/gmail_secure_mcp.py

🔒 安全注意事项

• ✅ 使用Google应用密码，而不是账户密码
• ✅ .env文件已添加到.gitignore，不会上传
• ✅ 建议仅在内网或VPN环境中使用
• ⚠️ 公共部署需要额外的安全措施

🤝 贡献

欢迎提交Issue和Pull Request！

📄 授权

MIT License

🙏 致谢

• FastMCP - 优秀的MCP框架
• Model Context Protocol - MCP协议规范

---

享受通过Cursor发送电子邮件的便利！ 📧✨