Email MCP Server

一个基于Model Context Protocol (MCP) 的邮件服务器，让AI可以发送、读取、搜索、删除和回复邮件。支持SMTP和Gmail API两种方式，兼容QQ邮箱、163邮箱、Gmail等常见邮箱服务。

🚀 功能特性

✉️ 发送邮件 - 支持HTML/纯文本格式，附件功能
📥 读取邮件 - 从收件箱或指定文件夹读取邮件
🔍 搜索邮件 - 按关键词搜索邮件
🗑️ 删除邮件 - 删除指定邮件
↩️ 回复邮件 - 支持回复和全部回复

📦 安装

npm install
npm run build

或者快速安装：

npm run quick-setup

⚙️ 配置

复制环境变量模板：

cp env.example .env

编辑 .env 文件，选择邮件提供商：

选项一：使用QQ邮箱 (推荐)

EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.qq.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-email@qq.com
SMTP_PASS=your-authorization-code
DEFAULT_FROM_EMAIL=your-email@qq.com

QQ邮箱设置步骤：

登录QQ邮箱 → 设置 → 账户
开启SMTP服务
生成授权码（不是QQ密码）
将授权码填入SMTP_PASS

选项二：使用163邮箱

EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.163.com
SMTP_PORT=994
SMTP_SECURE=true
SMTP_USER=your-email@163.com
SMTP_PASS=your-authorization-code
DEFAULT_FROM_EMAIL=your-email@163.com

选项三：使用Gmail

EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
DEFAULT_FROM_EMAIL=your-email@gmail.com

选项四：使用Gmail API

EMAIL_PROVIDER=gmail
GMAIL_CLIENT_ID=your-gmail-client-id
GMAIL_CLIENT_SECRET=your-gmail-client-secret
GMAIL_REFRESH_TOKEN=your-gmail-refresh-token
DEFAULT_FROM_EMAIL=your-email@gmail.com

🔧 使用方法

直接启动

npm run start

使用SuperGateway调试 (推荐)

npm run start-gateway

服务将在 http://localhost:3200 启动

在Cline中配置

{
  "mcpServers": {
    "email-mcp": {
      "url": "http://localhost:3200/sse",
      "type": "sse",
      "disabled": false,
      "autoApprove": [
        "send_email",
        "read_emails", 
        "search_emails",
        "delete_email",
        "reply_email"
      ]
    }
  }
}

开发模式

npm run dev

🛠️ 可用工具

1. send_email

发送邮件给指定收件人

参数：

to (必需): 收件人邮箱地址
subject (必需): 邮件主题
body (必需): 邮件内容
from (可选): 发件人邮箱地址
html (可选): 是否为HTML格式
attachments (可选): 附件数组

示例：

{
  "to": "recipient@qq.com",
  "subject": "来自AI的问候",
  "body": "这是一封由AI助手发送的测试邮件。",
  "html": false
}

2. read_emails

从收件箱或指定文件夹读取邮件

参数：

limit (可选): 邮件数量限制 (默认: 10)
folder (可选): 邮件文件夹 (默认: "INBOX")
unreadOnly (可选): 只读取未读邮件 (默认: false)

3. search_emails

搜索邮件

参数：

query (必需): 搜索关键词
limit (可选): 结果数量限制 (默认: 10)
folder (可选): 搜索文件夹 (默认: "INBOX")

4. delete_email

删除邮件

参数：

messageId (必需): 要删除的邮件ID

5. reply_email

回复邮件

参数：

messageId (必需): 原邮件ID
body (必需): 回复内容
replyAll (可选): 是否回复全部 (默认: false)
html (可选): 是否为HTML格式 (默认: false)

🔐 支持的邮箱服务

邮箱服务	SMTP服务器	端口	安全连接	说明
QQ邮箱	smtp.qq.com	587	false	需要开启SMTP服务并获取授权码
163邮箱	smtp.163.com	994	true	需要开启SMTP服务并获取授权码
Gmail	smtp.gmail.com	587	false	需要开启两步验证并生成应用密码
Outlook	smtp-mail.outlook.com	587	false	需要开启SMTP认证

🐛 故障排除

常见问题

QQ邮箱认证失败
- 确保已开启SMTP服务
- 使用授权码而不是QQ密码
- 检查SMTP设置是否正确
163邮箱认证失败
- 确保已开启SMTP服务
- 使用客户端授权密码
- 注意端口使用994并开启SSL
Gmail认证失败
- 确保启用了"应用密码"
- 开启两步验证
- 检查SMTP设置是否正确
Gmail API错误
- 确保OAuth令牌有效
- 检查API配额和权限
TypeScript编译错误
- 运行 npm install 确保依赖安装完整
- 检查Node.js版本 (推荐 v18+)

🔗 相关链接

Model Context Protocol
SuperGateway
Gmail API文档
QQ邮箱SMTP设置
AWS 部署文档
163邮箱查询邮件信息时候出现Unsafe Login. Please contact kefu@188.com for help。 https://m.lihuanting.com/blog/a/19

�� 许可证

ISC License

☁️ AWS 部署

本项目支持一键部署到 AWS 云平台，使用 EC2 + ALB 架构。

快速部署

# 1. 配置 AWS 凭证
aws configure

# 2. 创建 .env 文件
cp env.example .env
# 编辑 .env 配置邮件账户

# 3. 运行部署脚本
cd cdk
./deploy.sh

部署完成后，你将获得一个 ALB 端点，可以在 MCP 客户端中使用：

http://<alb-dns-name>:9095/sse

详细部署文档请参考 cdk/DEPLOYMENT.md

部署架构

ALB: 应用负载均衡器（端口 9095）
EC2: t3.small 实例运行 SuperGateway（端口 3200）
S3: 存储部署代码包
CloudWatch: 集中日志管理

成本估算

约 $35/月（us-east-1 区域）

Email MCP Server

🚀 功能特性

✉️ 发送邮件 - 支持HTML/纯文本格式，附件功能
📥 读取邮件 - 从收件箱或指定文件夹读取邮件
🔍 搜索邮件 - 按关键词搜索邮件
🗑️ 删除邮件 - 删除指定邮件
↩️ 回复邮件 - 支持回复和全部回复

📦 安装

npm install
npm run build

或者快速安装：

npm run quick-setup

⚙️ 配置

复制环境变量模板：

cp env.example .env

编辑 .env 文件，选择邮件提供商：

选项一：使用QQ邮箱 (推荐)

EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.qq.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-email@qq.com
SMTP_PASS=your-authorization-code
DEFAULT_FROM_EMAIL=your-email@qq.com

QQ邮箱设置步骤：

登录QQ邮箱 → 设置 → 账户
开启SMTP服务
生成授权码（不是QQ密码）
将授权码填入SMTP_PASS

选项二：使用163邮箱

EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.163.com
SMTP_PORT=994
SMTP_SECURE=true
SMTP_USER=your-email@163.com
SMTP_PASS=your-authorization-code
DEFAULT_FROM_EMAIL=your-email@163.com

选项三：使用Gmail

EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
DEFAULT_FROM_EMAIL=your-email@gmail.com

选项四：使用Gmail API

EMAIL_PROVIDER=gmail
GMAIL_CLIENT_ID=your-gmail-client-id
GMAIL_CLIENT_SECRET=your-gmail-client-secret
GMAIL_REFRESH_TOKEN=your-gmail-refresh-token
DEFAULT_FROM_EMAIL=your-email@gmail.com

🔧 使用方法

直接启动

npm run start

使用SuperGateway调试 (推荐)

npm run start-gateway

服务将在 http://localhost:3200 启动

在Cline中配置

{
  "mcpServers": {
    "email-mcp": {
      "url": "http://localhost:3200/sse",
      "type": "sse",
      "disabled": false,
      "autoApprove": [
        "send_email",
        "read_emails", 
        "search_emails",
        "delete_email",
        "reply_email"
      ]
    }
  }
}

开发模式

npm run dev

🛠️ 可用工具

1. send_email

发送邮件给指定收件人

参数：

to (必需): 收件人邮箱地址
subject (必需): 邮件主题
body (必需): 邮件内容
from (可选): 发件人邮箱地址
html (可选): 是否为HTML格式
attachments (可选): 附件数组

示例：

{
  "to": "recipient@qq.com",
  "subject": "来自AI的问候",
  "body": "这是一封由AI助手发送的测试邮件。",
  "html": false
}

2. read_emails

从收件箱或指定文件夹读取邮件

参数：

limit (可选): 邮件数量限制 (默认: 10)
folder (可选): 邮件文件夹 (默认: "INBOX")
unreadOnly (可选): 只读取未读邮件 (默认: false)

3. search_emails

搜索邮件

参数：

query (必需): 搜索关键词
limit (可选): 结果数量限制 (默认: 10)
folder (可选): 搜索文件夹 (默认: "INBOX")

4. delete_email

删除邮件

参数：

messageId (必需): 要删除的邮件ID

5. reply_email

回复邮件

参数：

messageId (必需): 原邮件ID
body (必需): 回复内容
replyAll (可选): 是否回复全部 (默认: false)
html (可选): 是否为HTML格式 (默认: false)

🔐 支持的邮箱服务

邮箱服务	SMTP服务器	端口	安全连接	说明
QQ邮箱	smtp.qq.com	587	false	需要开启SMTP服务并获取授权码
163邮箱	smtp.163.com	994	true	需要开启SMTP服务并获取授权码
Gmail	smtp.gmail.com	587	false	需要开启两步验证并生成应用密码
Outlook	smtp-mail.outlook.com	587	false	需要开启SMTP认证

🐛 故障排除

常见问题

QQ邮箱认证失败
- 确保已开启SMTP服务
- 使用授权码而不是QQ密码
- 检查SMTP设置是否正确
163邮箱认证失败
- 确保已开启SMTP服务
- 使用客户端授权密码
- 注意端口使用994并开启SSL
Gmail认证失败
- 确保启用了"应用密码"
- 开启两步验证
- 检查SMTP设置是否正确
Gmail API错误
- 确保OAuth令牌有效
- 检查API配额和权限
TypeScript编译错误
- 运行 npm install 确保依赖安装完整
- 检查Node.js版本 (推荐 v18+)

🔗 相关链接

Model Context Protocol
SuperGateway
Gmail API文档
QQ邮箱SMTP设置
AWS 部署文档
163邮箱查询邮件信息时候出现Unsafe Login. Please contact kefu@188.com for help。 https://m.lihuanting.com/blog/a/19

�� 许可证

ISC License

☁️ AWS 部署

本项目支持一键部署到 AWS 云平台，使用 EC2 + ALB 架构。

快速部署

# 1. 配置 AWS 凭证
aws configure

# 2. 创建 .env 文件
cp env.example .env
# 编辑 .env 配置邮件账户

# 3. 运行部署脚本
cd cdk
./deploy.sh

部署完成后，你将获得一个 ALB 端点，可以在 MCP 客户端中使用：

http://<alb-dns-name>:9095/sse

详细部署文档请参考 cdk/DEPLOYMENT.md

部署架构

ALB: 应用负载均衡器（端口 9095）
EC2: t3.small 实例运行 SuperGateway（端口 3200）
S3: 存储部署代码包
CloudWatch: 集中日志管理

成本估算

约 $35/月（us-east-1 区域）