📧 通用邮箱 MCP Server
一个让AI轻松接管邮箱的通用MCP服务器,基于 Model Context Protocol (MCP) 构建,支持在 MCP-X、Claude Desktop 等 MCP 客户端中使用。
支持多种邮箱服务商自动配置:QQ邮箱、163邮箱、Gmail、Outlook、腾讯企业邮箱、网易企业邮箱、阿里云企业邮箱、阿里云邮箱、新浪邮箱、搜狐邮箱等。
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add mcp-email -- npx -y mcp-email@1.0.1รันในเทอร์มินัล
{ "mcpServers": { "mcp-email": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
# npm 安装
npm install -g mcp-email
# 使用 npx 运行(推荐)
npx mcp-email
项目提供了详细的配置指南,包含各大邮箱服务商的配置说明:
📖 CONFIG_GUIDE.md - 完整配置指南,包含:
# 全局安装
npm install -g mcp-email
# 或本地安装
npm install mcp-email
MCP-X 配置示例:
{
"mcpServers": {
"universal-email": {
"command": "npx",
"args": ["mcp-email"],
"env": {
"EMAIL_USER": "[email protected]",
"EMAIL_PASSWORD": "your-password-or-auth-code",
"EMAIL_TYPE": "auto"
}
}
}
}
git clone https://github.com/TimeCyber/email-mcp.git
cd email-mcp
npm install
MCP-X 配置:
{
"mcpServers": {
"universal-email": {
"command": "node",
"args": ["F:\\path\\to\\email-mcp\\index.js"],
"env": {
"EMAIL_USER": "[email protected]",
"EMAIL_PASSWORD": "your-password-or-auth-code",
"EMAIL_TYPE": "auto"
}
}
}
}
企业邮箱配置(腾讯企业邮箱):
{
"mcpServers": {
"enterprise-email": {
"command": "node",
"args": ["F:\\path\\to\\email-mcp\\index.js"],
"env": {
"EMAIL_USER": "[email protected]",
"EMAIL_PASSWORD": "your-enterprise-auth-code",
"EMAIL_TYPE": "exmail"
}
}
}
}
阿里云企业邮箱配置:
{
"mcpServers": {
"aliyun-enterprise-email": {
"command": "node",
"args": ["F:\\path\\to\\email-mcp\\index.js"],
"env": {
"EMAIL_USER": "[email protected]",
"EMAIL_PASSWORD": "your-enterprise-auth-code",
"EMAIL_TYPE": "aliyun-enterprise"
}
}
}
}
服务器:SMTP
smtp.qiye.aliyun.com:465、IMAPimap.qiye.aliyun.com:993、POP3pop.qiye.aliyun.com:995(均启用 SSL)
# 测试邮件配置是否成功
node test-auto-config.js
不同邮箱的授权码获取方式:
腾讯企业邮箱:
阿里云企业邮箱:
EMAIL_TYPE: "aliyun-enterprise"QQ邮箱:
163邮箱:
💡 关键提示:
EMAIL_TYPE 字段(如腾讯 "exmail"、阿里云 "aliyun-enterprise")!EMAIL_TYPE: "auto" 自动识别📖 CONFIG_GUIDE.md - 完整配置指南,包含所有邮箱类型详细说明
send_email - 发送邮件发送邮件,支持多种格式和收件人。
to (必需): 收件人邮箱地址数组subject (必需): 邮件主题text (必需): 纯文本邮件内容cc (可选): 抄送邮箱地址数组bcc (可选): 密送邮箱地址数组html (可选): HTML格式邮件内容attachments (可选): 附件数组基本邮件发送:
{
"to": ["[email protected]"],
"subject": "测试邮件",
"text": "这是一封测试邮件"
}
带抄送和HTML内容:
{
"to": ["[email protected]", "[email protected]"],
"cc": ["[email protected]"],
"subject": "项目报告",
"text": "请查看项目报告",
"html": "<h1>项目报告</h1><p>项目进展顺利。</p>"
}
带附件的邮件:
{
"to": ["[email protected]"],
"subject": "带附件的邮件",
"text": "请查看附件",
"attachments": [
{
"filename": "report.pdf",
"path": "C:\\path\\to\\report.pdf"
},
{
"filename": "data.txt",
"content": "SGVsbG8gV29ybGQ="
}
]
}
get_recent_emails - 获取最近邮件获取最近几天的邮件列表,自动选择最佳协议(IMAP/POP3)。
limit (可选): 返回邮件数量限制,默认20days (可选): 获取最近几天的邮件,默认3天{
"limit": 10,
"days": 7
}
get_email_content - 获取邮件内容获取指定邮件的详细内容。
uid (必需): 邮件唯一标识符(从邮件列表中获取){
"uid": "12345"
}
setup_email_account - 设置邮箱账号自动识别邮箱类型并配置服务器,支持 QQ / 163 / Gmail / Outlook / 腾讯企业邮 / 阿里云企业邮等多种服务商。
email (必需): 邮箱地址password (必需): 邮箱密码或授权码provider (可选): 邮箱提供商(手动指定,用于企业邮箱)qq - QQ邮箱163 - 网易邮箱gmail - Gmailoutlook - Outlook/Hotmailexmail - 腾讯企业邮箱netease-enterprise - 网易企业邮箱aliyun - 阿里云邮箱aliyun-enterprise - 阿里云企业邮箱sina - 新浪邮箱sohu - 搜狐邮箱个人邮箱(自动识别):
{
"email": "[email protected]",
"password": "your-auth-code"
}
企业邮箱(手动指定):
{
"email": "[email protected]",
"password": "your-enterprise-auth-code",
"provider": "exmail"
}
阿里云企业邮箱:
{
"email": "[email protected]",
"password": "your-enterprise-auth-code",
"provider": "aliyun-enterprise"
}
list_supported_providers - 列出支持的邮箱查看所有支持的邮箱服务商及其配置信息。
无需参数
{}
configure_email_server - 手动配置服务器手动配置邮箱服务器设置(高级用户使用)。
user (必需): 邮箱账号password (必需): 邮箱密码或授权码smtpHost (可选): SMTP服务器地址smtpPort (可选): SMTP端口smtpSecure (可选): 是否使用SSLimapHost (可选): IMAP服务器地址imapPort (可选): IMAP端口imapSecure (可选): 是否使用SSL{
"user": "[email protected]",
"password": "your-password",
"smtpHost": "smtp.domain.com",
"smtpPort": 465,
"smtpSecure": true
}
test_email_connection - 测试连接测试邮箱服务器连接状态。
testType (可选): 测试类型
smtp - 仅测试发送服务器imap - 仅测试接收服务器both - 测试全部(默认){
"testType": "smtp"
}
*网易邮箱(163/126/yeah)自动使用POP3协议以避免"Unsafe Login"错误
Gmail特殊说明: 从2025年5月1日起,Google Workspace账号不再支持"less secure apps",必须使用OAuth认证。个人Gmail需要使用应用专用密码。详见配置指南。*
EMAIL_TYPE 字段手动指定535 Error: authentication failed原因: 认证失败 解决方案:
[IMAP] EXAMINE Unsafe Login (网易邮箱常见)原因: 网易邮箱安全限制 解决方案:
ECONNREFUSED 或连接超时原因: 网络连接问题 解决方案:
EMAIL_TYPE 相关错误原因: 企业邮箱域名和服务器不匹配 解决方案:
EMAIL_TYPE 字段"exmail""aliyun-enterprise""netease-enterprise"使用内置诊断命令:
# 测试邮箱配置
node test-auto-config.js
# 测试EMAIL_TYPE功能
node test-email-type.js
# 使用MCP工具测试连接
# 在MCP客户端中调用 test_email_connection
test_email_connection 诊断问题list_supported_providers 确认支持setup_email_account 自动配置├── index.js # MCP Server主程序
├── package.json # 项目依赖配置
├── README.md # 项目主文档
├── CONFIG_GUIDE.md # 详细配置指南
├── .gitignore # Git忽略文件
├── 📁 配置模板/
│ ├── mcp-x_config_v2.json # 通用配置模板
│ └── mcp-x_config_multi.json # 多账户配置
├── 📁 测试工具/
│ ├── test-auto-config.js # 自动配置测试
│ └── test-email-type.js # EMAIL_TYPE功能测试
└── LICENSE # 开源许可证
index.js - 主要的MCP服务器程序,包含所有邮件功能CONFIG_GUIDE.md - 详细的配置指南,包含各种邮箱配置说明mcp-x_config_v2.json - 通用配置模板,支持EMAIL_TYPE字段test-auto-config.js - 测试自动配置功能的脚本test-email-type.js - 验证EMAIL_TYPE字段功能的测试脚本test-auto-config.js 和 test-email-type.jstest_email_connection 工具欢迎提交 Issue 和 Pull Request 来改进这个项目!
MIT License - 详见 LICENSE 文件
配置完成后,可以在MCP客户端中测试功能:
发送测试邮件:
请发送一封测试邮件到 [email protected],主题为"MCP测试邮件",内容为"Hello from Universal Email MCP!"
获取邮件列表:
请获取最近3天的邮件列表,限制10封邮件
测试连接:
请测试邮箱连接状态
如果一切配置正确,所有功能都应该正常工作!🚀
通用邮箱MCP服务器 - 支持QQ、163、Gmail(由于谷歌政策不支持OAuth2.0,所以无法使用)、Outlook、企业邮箱等多种邮箱服务商的自动配置和邮件发送功能
{ "mcpServers": { "mcp-email": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
MCP Email ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-17 通用邮箱MCP服务器 - 支持QQ、163、Gmail(由于谷歌政策不支持OAuth2.0,所以无法使用)、Outlook、企业邮箱等多种邮箱服务商的自动配置和邮件发送功能