Email MCP Server
一个基于 MCP Streamable HTTP 的通用邮箱服务。固定提供 5 个工具,支持通过标准 IMAP/SMTP 使用 QQ、163、126、Gmail、Outlook、Yahoo、iCloud、企业邮箱和自建邮箱, 同时保留 Gmail API 模式。
解决的问题
Issue #1 的根因是旧版本只有 send_email 使用 SMTP;读取、搜索、删除和回复全部写死为
Gmail API,因此 163 等邮箱只能发信。当前实现改为:
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट 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.
लॉन्चपब्लिशर से
一个基于 MCP Streamable HTTP 的通用邮箱服务。固定提供 5 个工具,支持通过标准 IMAP/SMTP 使用 QQ、163、126、Gmail、Outlook、Yahoo、iCloud、企业邮箱和自建邮箱, 同时保留 Gmail API 模式。
Issue #1 的根因是旧版本只有 send_email 使用 SMTP;读取、搜索、删除和回复全部写死为
Gmail API,因此 163 等邮箱只能发信。当前实现改为:
通用多邮箱 MCP 服务:原生 Streamable HTTP,固定 5 个工具,支持 IMAP/SMTP、Gmail API、多账号切换及 Env/Header 配置。
send_email、reply_email:标准 SMTP(或 Gmail API)。read_emails、search_emails、delete_email:标准 IMAP(或 Gmail API)。account 参数,可在命名账号之间逐次调用切换。X-Email-* Header 切换或覆盖连接配置,无需重启服务。要求 Node.js 18 或更高版本。
从 npm 全局安装:
npm install -g @xingyuchen/email-mcp
email-mcp-server
从源码运行:
npm install
cp .env.example .env
npm run build
npm start
默认仅监听本机回环地址:
http://localhost:3200/mcp
健康检查:
curl http://localhost:3200/health
这是原生 Streamable HTTP MCP,不再需要 SuperGateway,也不是旧的 /sse 协议。
配置服务器证书和私钥后,服务会直接启动为 HTTPS。TLS 会加密完整 HTTP 请求,包括
Authorization、所有 X-Email-* 请求头以及 JSON-RPC 正文,服务端解密后仍按原有方式
解析和使用这些字段:
MCP_HOST=0.0.0.0
MCP_PORT=3200
MCP_TLS_KEY_PATH=/etc/email-mcp/tls/server.key
MCP_TLS_CERT_PATH=/etc/email-mcp/tls/server.crt
MCP_TLS_MIN_VERSION=TLSv1.2
客户端连接:
https://mail-mcp.example.com:3200/mcp
证书必须由客户端信任,并且证书域名必须与 URL 主机名匹配。只配置证书或只配置私钥会 拒绝启动。非回环地址上的明文 HTTP 也会默认拒绝启动。
MCP_API_KEY 默认不启用。部署者需要额外的客户端鉴权时,可显式设置至少 32 字节的
MCP_API_KEY;设置后客户端再通过 Bearer 或 X-MCP-API-Key 发送它。
也可以由 Nginx、Caddy 或负载均衡器终止 HTTPS,此时保持 MCP_HOST=127.0.0.1,只允许
代理通过本机回环访问后端。只有代理可信且会覆盖 X-Forwarded-Proto 时才设置
MCP_TRUST_PROXY=true。如果要求 TLS 一直终止到 Node.js 进程,请使用上述原生 HTTPS。
先在 163 邮箱设置中启用 SMTP/IMAP,并使用客户端授权码而不是登录密码:
EMAIL_PROVIDER=imap-smtp
SMTP_HOST=smtp.163.com
SMTP_PORT=465
SMTP_SECURE=true
[email protected]
SMTP_PASS=your-authorization-code
IMAP_HOST=imap.163.com
IMAP_PORT=993
IMAP_SECURE=true
[email protected]
IMAP_PASS=your-authorization-code
[email protected]
对于常见邮箱,可只配置账号和授权码,服务器会根据邮箱域名补全主机、端口和 TLS:
EMAIL_PROVIDER=imap-smtp
[email protected]
SMTP_PASS=your-authorization-code
[email protected]
当 IMAP_USER/IMAP_PASS 未设置时,会复用 SMTP 凭据;反向亦然。企业邮箱或自建邮箱
只需显式填写对应的 SMTP_* 和 IMAP_* 地址即可。
EMAIL_PROVIDER=gmail-api
GMAIL_CLIENT_ID=...
GMAIL_CLIENT_SECRET=...
GMAIL_REFRESH_TOKEN=...
[email protected]
也可只传有效的 GMAIL_ACCESS_TOKEN。如果使用 Gmail 的标准 IMAP/SMTP,则将
EMAIL_PROVIDER 设为 imap-smtp 并使用应用专用密码。
使用 EMAIL_ACCOUNTS_JSON 定义命名账号:
EMAIL_DEFAULT_ACCOUNT=personal
EMAIL_ACCOUNTS_JSON={"personal":{"provider":"imap-smtp","from":"[email protected]","smtp":{"user":"[email protected]","pass":"qq-code"},"imap":{"user":"[email protected]","pass":"qq-code"}},"work":{"provider":"imap-smtp","from":"[email protected]","smtp":{"user":"[email protected]","pass":"work-code"},"imap":{"user":"[email protected]","pass":"work-code"}}}
随后直接在原有工具中选择账号:
{
"account": "work",
"limit": 10,
"folder": "INBOX"
}
read_emails 和 search_emails 返回的 messageId 是不包含密码的定位符,其中保留了
命名账号和 IMAP 文件夹信息。把它直接传给 reply_email 或 delete_email 时,通常无需
再次填写 account。
MCP 客户端可以为 Streamable HTTP 连接设置静态 Header:
{
"mcpServers": {
"email": {
"type": "streamable-http",
"url": "https://mail-mcp.example.com:3200/mcp",
"headers": {
"X-Email-Account": "work"
}
}
}
}
也可以完全通过 Header 提供连接信息:
{
"X-Email-Provider": "imap-smtp",
"X-Email-From": "[email protected]",
"X-Email-SMTP-Host": "smtp.example.com",
"X-Email-SMTP-Port": "465",
"X-Email-SMTP-Secure": "true",
"X-Email-SMTP-User": "[email protected]",
"X-Email-SMTP-Pass": "app-password",
"X-Email-IMAP-Host": "imap.example.com",
"X-Email-IMAP-Port": "993",
"X-Email-IMAP-Secure": "true",
"X-Email-IMAP-User": "[email protected]",
"X-Email-IMAP-Pass": "app-password"
}
还支持 X-Email-Config,值为完整 JSON,或 base64:<base64url-json>。可用字段与
EMAIL_ACCOUNTS_JSON 内单个账号相同。Base64url 只是编码,不是加密;机密性由 HTTPS
提供。
配置优先级从高到低:
X-Email-* 连接 Header。X-Email-Config。account 参数或 X-Email-Account 选中的命名账号。账号选择优先级为:工具 account > X-Email-Account > X-Email-Config.account >
EMAIL_DEFAULT_ACCOUNT。
Header 中可能包含邮箱授权码。跨机器部署时必须使用 HTTPS;需要客户端鉴权时再设置
MCP_API_KEY。不要在日志中打印请求头。
五个工具均支持可选 account 参数。
通用 IMAP 搜索支持普通文本,以及:
from:[email protected] subject:"quarterly report" since:2026-01-01 before:2026-08-01 is:unread
npm test
共 15 项自动化测试,覆盖配置优先级、163 IMAP 泛化、命名账号切换、请求头覆盖、消息 定位符、搜索语法、标准 IMAP 读/搜/删、SMTP 发/回、HTTP/HTTPS Streamable HTTP、网络部署 安全策略、证书校验保护、强制 STARTTLS 和工具数量不变约束。
通用多邮箱 MCP 服务:原生 Streamable HTTP,固定 5 个工具,支持 IMAP/SMTP、Gmail API、多账号切换及 Env/Header 配置。
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Email stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। 通用多邮箱 MCP 服务:原生 Streamable HTTP,固定 5 个工具,支持 IMAP/SMTP、Gmail API、多账号切换及 Env/Header 配置。