Email Doc Sender MCP

一个基于 MCP (Model Context Protocol) 的本地服务器，为 AI 助手提供邮件发送能力。

功能特性

• 📧 邮件发送: 通过 AI 助手发送邮件
• 📄 多格式支持: Markdown、HTML、纯文本、附件
• 🔒 安全可靠: 支持 TLS/SSL 加密传输
• ⚙️ 灵活配置: 支持配置文件和环境变量
• 🤖 智能判断: 自动检测内容格式

安装

Claude CLI (推荐)

claude mcp add email-doc-sender --scope user -- npx email-doc-sender@latest

全局安装

npm install -g email-doc-sender

从源码安装

git clone <repository-url>
cd email-doc-sender
npm install
npm run build

配置

配置文件

创建配置文件 ~/.email-doc-sender/config.json：

{
  "host": "smtp.qq.com",
  "port": 587,
  "secure": false,
  "auth": {
    "user": "[email protected]",
    "pass": "授权码"
  },
  "from": "[email protected]"
}

环境变量 (可选，优先级更高)

• EMAIL_SMTP_HOST - SMTP 服务器地址
• EMAIL_SMTP_PORT - SMTP 端口
• EMAIL_SMTP_SECURE - 是否使用 SSL (true/false)
• EMAIL_SMTP_USER - 邮箱用户名
• EMAIL_SMTP_PASS - 邮箱密码或授权码
• EMAIL_FROM - 发件人邮箱地址

邮箱配置示例

QQ 邮箱

• 获取授权码：设置 → 账户 → POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务 → 生成授权码
• SMTP: smtp.qq.com:587, secure: false

163 邮箱

• SMTP: smtp.163.com:465, secure: true

Gmail

• 需要启用应用专用密码
• SMTP: smtp.gmail.com:587, secure: false

Outlook / Microsoft 365

Outlook.com (个人账户)

| 参数 | 值 | |------|-----| | SMTP 服务器 | smtp-mail.outlook.com | | 端口 | 587 | | 加密方式 | STARTTLS (secure: false) |

Microsoft 365 / Office 365 (企业账户)

| 参数 | 值 | |------|-----| | SMTP 服务器 | smtp.office365.com | | 端口 | 587 | | 加密方式 | STARTTLS (secure: false) |

重要提示: 如果启用了双因素验证 (2FA),需要生成应用专用密码，使用应用密码而非账户密码。

126 / 163 邮箱

• SMTP: smtp.163.com:465, secure: true

使用

配置完成后重启 Claude，然后：

# 发送文字
请把这段文字发送到 [email protected]

# 发送文件
请把 README.md 作为附件发送到 [email protected]

# 发送 Markdown
请把项目总结发送到 [email protected]

故障排查

• 认证失败: 检查是否使用授权码，确认 SMTP 服务已开启
• 连接超时: 检查网络和 SMTP 配置
• 配置不生效: 环境变量优先级高于配置文件

开发

npm run dev    # 开发模式
npm run build  # 构建
npm test       # 测试

许可证

MIT