🚀 Gmail 发件人 MCP 服务器

这是一个模型上下文协议（MCP）服务器，允许Claude和其他人工智能助手通过Gmail API发送电子邮件。此版本专注于仅提供电子邮件发送功能，为AI助手提供了便捷的邮件交互途径。

🚀 快速开始

该项目创建的MCP服务器，能让AI助手实现发送新邮件以及回复现有邮件的功能。它设计轻量级且易于设置，借助Gmail API进行邮件操作。

✨ 主要特性

• 功能明确：仅专注于电子邮件发送功能，包括发送新邮件和回复现有邮件。
• 轻量易设：设计轻量级，且设置过程简单。
• API支持：使用Gmail API进行电子邮件操作。

📦 安装指南

先决条件

• Python 3.8或更高版本
• 具有Gmail API启用的Google Cloud账户
• Docker（可选，用于容器化部署）

设置步骤

1. 创建Google Cloud项目并启用Gmail API

1. 转到Google Cloud控制台
2. 创建新项目或选择现有项目
3. 在侧边栏中导航到“API和服务”>“库”
4. 搜索“Gmail API”并启用它
5. 转到“API和服务”>“凭证”
6. 点击“创建凭据”，然后选择“OAuth客户端ID”
7. 对于应用程序类型，选择“桌面应用”
8. 为您的OAuth客户端命名
9. 点击“创建”
10. 下载生成的凭据JSON文件

2. 准备您的环境

克隆此仓库：

git clone https://github.com/abhishekloiwal/gmail-sender-mcp.git
cd gmail-sender-mcp

安装依赖项：

pip install -r requirements.txt

3. 设置您的凭证

1. 将下载的凭据文件重命名为credentials.json并放在项目根目录中
2. 运行辅助脚本来获取刷新令牌：

python get_refresh_token.py

3. 在浏览器中完成身份验证流程
4. 复制终端中显示的刷新令牌
5. 基于示例创建.env文件：

cp .env.example .env

6. 编辑.env文件并填写您的凭证：

GMAIL_CLIENT_ID=your-client-id.apps.googleusercontent.com
GMAIL_CLIENT_SECRET=your-client-secret
GMAIL_REFRESH_TOKEN=your-refresh-token
GMAIL_USER_EMAIL=your-email@gmail.com

4. 运行MCP服务器

python gmail_sender.py

服务器将启动并监听连接。

Docker 部署

您也可以在Docker容器中运行服务器：

使用Docker构建和运行

docker build -t gmail-sender-mcp .
docker run -d --name gmail-sender-mcp --env-file .env gmail-sender-mcp

或使用Docker Compose

docker-compose up -d

💻 使用示例

基础用法

要将此MCP服务器与AI助手一起使用，请执行以下操作：

1. 运行MCP服务器
2. 将您的AI助手连接到MCP服务器（具体步骤取决于您的AI平台）

工具使用

send_email 工具

发送新的电子邮件。 参数：

• to: 收件人电子邮件地址
• subject: 电子邮件主题行
• body: 电子邮件正文内容（支持HTML格式）

reply_to_email 工具

回复现有的电子邮件。 参数：

• email_id: 要回复的电子邮件ID
• body: 回复内容（支持HTML格式）

示例代码

以下是一个使用send_email工具的示例：

from gmail_sender import GmailSender

# 初始化Gmail发送器
gmail = GmailSender(
    client_id='your-client-id.apps.googleusercontent.com',
    client_secret='your-client-secret',
    refresh_token='your-refresh-token',
    user_email='your-email@gmail.com'
)

# 发送电子邮件
gmail.send_email(
    to='recipient@example.com',
    subject='测试邮件',
    body='这是一封测试邮件。'
)

📚 详细文档

环境变量说明

以下是.env文件中可能用到的环境变量及其含义：

GMAIL_CLIENT_ID: Gmail OAuth客户端ID
GMAIL_CLIENT_SECRET: Gmail OAuth客户端密钥
GMAIL_REFRESH_TOKEN: Gmail刷新令牌
GMAIL_USER_EMAIL: 要发送电子邮件的Google账户电子邮件地址
SMTP_SERVER: SMTP服务器地址（默认为smtp.gmail.com）
SMTP_PORT: SMTP端口（默认为587）

错误处理

在使用Gmail API时，可能会遇到以下错误：

1. InvalidGrantError: 刷新令牌无效或已过期
2. RateLimitExceeded: 超出API配额限制
3. PermissionDenied: 缺乏必要的权限

确保您的凭据有效，并且您的Google Cloud项目启用了正确的API。

🔧 技术细节

该项目使用Python编写，借助Gmail API实现邮件发送和回复功能。通过OAuth 2.0进行身份验证，使用刷新令牌来维持长期的API访问权限。同时，支持Docker容器化部署，方便在不同环境中使用。

📄 许可证

文档未提及许可证相关信息。

⚠️ 重要提示

• 保持.env文件安全，且永远不会将其提交到版本控制中。
• 刷新令牌授予发送邮件的权限，因此请像处理密码一样处理它。
• 如果您担心安全问题，请考虑使用专用的Google账户进行此集成。

💡 使用建议

• 若遇到身份验证错误，确保.env文件中的凭证正确无误。
• 若出现找不到模块错误，检查Python环境是否已正确安装所有依赖项。
• 若遇到Gmail API配额限制，请联系Google Cloud支持增加配额。