内容
# @fuyouai/email-mcp
通过 **MCP** 读写邮箱：收信用 **IMAP**，发信用 **SMTP**。默认参数适配腾讯企业邮箱（`exmail.qq.com`）。
## 工具
| Tool | 说明 |
|------|------|
| `list_folders` | 列出文件夹 |
| `list_messages` | 列出邮件摘要 |
| `search_messages` | 按条件搜索 |
| `get_message` | 读取单封正文与附件信息 |
| `send_message` | 发送邮件（环境变量 `SMTP_ENABLED=false` 时不注册） |
## 要求
- Node.js 18+
- 邮箱已开启 IMAP；发信需开启 SMTP
- 腾讯企业邮开启安全登录时，使用**客户端专用密码**（[IMAP 说明](http://service.rtxmail.net/help/234.html)）
## 在 Cursor 中使用
```bash
npx -y @fuyouai/email-mcp
```
`mcp.json` 示例（把账号与密码换成你自己的；密码不要提交到仓库）：
```json
{
"mcpServers": {
"email": {
"command": "npx",
"args": ["-y", "@fuyouai/email-mcp"],
"env": {
"IMAP": "imap.exmail.qq.com:993",
"MAIL_USER": "you@yourcompany.com",
"MAIL_PASSWORD": "客户端专用密码",
"IMAP_SECURE": "true",
"SMTP": "smtp.exmail.qq.com:465",
"SMTP_SECURE": "true",
"SMTP_ENABLED": "true"
}
}
}
}
```
安装到全局后，可执行 CLI：`email-mcp`。
## 环境变量
| 变量 | 说明 | 默认 |
|------|------|------|
| `IMAP` | 收信 `host:port` | `imap.exmail.qq.com:993` |
| `MAIL_USER` | 登录邮箱（收/发共用） | 必填 |
| `MAIL_PASSWORD` | 密码或客户端专用密码 | 必填 |
| `IMAP_SECURE` | IMAP 使用 TLS | `true` |
| `MAX_BODY_CHARS` | 读信正文最大长度 | `8000` |
| `SMTP` | 发信 `host:port` | `smtp.exmail.qq.com:465` |
| `SMTP_SECURE` | SMTP 使用 TLS | `true` |
| `SMTP_ENABLED` | 是否注册发信工具 | `true` |
| `SMTP_USER` / `SMTP_PASSWORD` | 发信账号与收信不同时填写 | 默认同 `MAIL_*` |
| `SMTP_FROM` | 发件人显示地址 | 默认同发信登录账号 |
海外机房可将 `IMAP` / `SMTP` 改为 `hwimap.exmail.qq.com:993`、`hwsmtp.exmail.qq.com:465`。
## `send_message` 参数示例
```json
{
"to": "colleague@company.com",
"subject": "会议提醒",
"text": "明天下午 3 点开会。"
}
```
多个收件人：`"to": "a@x.com, b@x.com"` 或 `"to": ["a@x.com", "b@x.com"]`。`text` 与 `html` 至少填一项。
