项目进展顺利。
\"\n}\n```\n\n**带附件的邮件：**\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"带附件的邮件\",\n \"text\": \"请查看附件\",\n \"attachments\": [\n {\n \"filename\": \"report.pdf\",\n \"path\": \"C:\\\\path\\\\to\\\\report.pdf\"\n },\n {\n \"filename\": \"data.txt\",\n \"content\": \"SGVsbG8gV29ybGQ=\"\n }\n ]\n}\n```\n\n### 2. `get_recent_emails` - 获取最近邮件\n\n获取最近几天的邮件列表，自动选择最佳协议（IMAP/POP3）。\n\n#### 参数\n- **`limit`** (可选): 返回邮件数量限制，默认20\n- **`days`** (可选): 获取最近几天的邮件，默认3天\n\n#### 使用示例\n```json\n{\n \"limit\": 10,\n \"days\": 7\n}\n```\n\n### 3. `get_email_content` - 获取邮件内容\n\n获取指定邮件的详细内容。\n\n#### 参数\n- **`uid`** (必需): 邮件唯一标识符（从邮件列表中获取）\n\n#### 使用示例\n```json\n{\n \"uid\": \"12345\"\n}\n```\n\n### 4. `setup_email_account` - 设置邮箱账号\n\n自动识别邮箱类型并配置服务器，支持8大邮箱服务商。\n\n#### 参数\n- **`email`** (必需): 邮箱地址\n- **`password`** (必需): 邮箱密码或授权码\n- **`provider`** (可选): 邮箱提供商（手动指定，用于企业邮箱）\n\n#### 支持的邮箱类型\n- `qq` - QQ邮箱\n- `163` - 网易邮箱\n- `gmail` - Gmail\n- `outlook` - Outlook/Hotmail\n- `exmail` - 腾讯企业邮箱\n- `netease-enterprise` - 网易企业邮箱\n- `aliyun` - 阿里云邮箱\n- `sina` - 新浪邮箱\n- `sohu` - 搜狐邮箱\n\n#### 使用示例\n\n**个人邮箱（自动识别）：**\n```json\n{\n \"email\": \"user@qq.com\",\n \"password\": \"your-auth-code\"\n}\n```\n\n**企业邮箱（手动指定）：**\n```json\n{\n \"email\": \"user@company.com\",\n \"password\": \"your-enterprise-auth-code\",\n \"provider\": \"exmail\"\n}\n```\n\n### 5. `list_supported_providers` - 列出支持的邮箱\n\n查看所有支持的邮箱服务商及其配置信息。\n\n#### 参数\n无需参数\n\n#### 使用示例\n```json\n{}\n```\n\n### 6. `configure_email_server` - 手动配置服务器\n\n手动配置邮箱服务器设置（高级用户使用）。\n\n#### 参数\n- **`user`** (必需): 邮箱账号\n- **`password`** (必需): 邮箱密码或授权码\n- **`smtpHost`** (可选): SMTP服务器地址\n- **`smtpPort`** (可选): SMTP端口\n- **`smtpSecure`** (可选): 是否使用SSL\n- **`imapHost`** (可选): IMAP服务器地址\n- **`imapPort`** (可选): IMAP端口\n- **`imapSecure`** (可选): 是否使用SSL\n\n#### 使用示例\n```json\n{\n \"user\": \"your-email@domain.com\",\n \"password\": \"your-password\",\n \"smtpHost\": \"smtp.domain.com\",\n \"smtpPort\": 465,\n \"smtpSecure\": true\n}\n```\n\n### 7. `test_email_connection` - 测试连接\n\n测试邮箱服务器连接状态。\n\n#### 参数\n- **`testType`** (可选): 测试类型\n - `smtp` - 仅测试发送服务器\n - `imap` - 仅测试接收服务器\n - `both` - 测试全部（默认）\n\n#### 使用示例\n```json\n{\n \"testType\": \"smtp\"\n}\n```\n\n## 📊 支持的邮箱服务商\n\n### 主流邮箱服务器配置\n\n| 邮箱类型 | SMTP服务器 | SMTP端口 | IMAP服务器 | IMAP端口 | 推荐协议 |\n|---------|------------|----------|------------|----------|----------|\n| QQ邮箱 | smtp.qq.com | 587 | imap.qq.com | 993 | IMAP |\n| 网易邮箱 | smtp.163.com | 465 | imap.163.com | 993 | POP3* |\n| Gmail* | smtp.gmail.com | 587 | imap.gmail.com | 993 | IMAP |\n| Outlook | smtp-mail.outlook.com | 587 | outlook.office365.com | 993 | IMAP |\n| 腾讯企业邮箱 | smtp.exmail.qq.com | 465 | imap.exmail.qq.com | 993 | IMAP |\n\n| 阿里云邮箱 | smtp.mxhichina.com | 465 | imap.mxhichina.com | 993 | IMAP |\n\n***网易邮箱（163/126/yeah）自动使用POP3协议以避免\"Unsafe Login\"错误**\n\n***Gmail特殊说明**: 从2025年5月1日起，Google Workspace账号不再支持\"less secure apps\"，必须使用OAuth认证。个人Gmail需要使用应用专用密码。详见[配置指南](CONFIG_GUIDE.md#gmail-详细配置教程)。**\n\n### 🔧 自动配置特性\n\n- ✅ **智能识别**: 根据邮箱域名自动选择服务器配置\n- ✅ **协议优化**: 163邮箱自动使用POP3，其他使用IMAP\n- ✅ **企业邮箱**: 支持通过 `EMAIL_TYPE` 字段手动指定\n- ✅ **错误处理**: IMAP失败时自动尝试POP3协议\n\n## 🔍 故障排除\n\n### 常见错误和解决方案\n\n#### 1. `535 Error: authentication failed`\n**原因**: 认证失败\n**解决方案**:\n- 确认已在邮箱设置中开启SMTP/IMAP/POP3服务\n- 重新生成授权码或应用专用密码\n- 检查邮箱地址和授权码是否正确\n- 对于企业邮箱，确认管理员已允许第三方访问\n\n#### 2. `[IMAP] EXAMINE Unsafe Login` (网易邮箱常见)\n**原因**: 网易邮箱安全限制\n**解决方案**:\n- 系统会自动切换到POP3协议\n- 确认已在网易邮箱中开启POP3/SMTP服务\n- 使用最新生成的16位授权码\n\n#### 3. `ECONNREFUSED` 或连接超时\n**原因**: 网络连接问题\n**解决方案**:\n- 检查网络连接状态\n- 确认防火墙没有阻挡邮件端口 (25, 465, 587, 993, 995)\n- 尝试不同的网络环境或VPN\n\n#### 4. `EMAIL_TYPE` 相关错误\n**原因**: 企业邮箱域名和服务器不匹配\n**解决方案**:\n- 为企业邮箱设置正确的 `EMAIL_TYPE` 字段\n- 腾讯企业邮箱设置为 `\"exmail\"`\n- 网易企业邮箱设置为 `\"netease-enterprise\"`\n\n### 📋 诊断工具\n\n使用内置诊断命令：\n\n```bash\n# 测试邮箱配置\nnode test-auto-config.js\n\n# 测试EMAIL_TYPE功能\nnode test-email-type.js\n\n# 使用MCP工具测试连接\n# 在MCP客户端中调用 test_email_connection\n```\n\n### 🔧 调试技巧\n\n1. **查看详细日志**: 系统会自动输出配置和连接信息\n2. **使用测试工具**: 通过 `test_email_connection` 诊断问题\n3. **检查邮箱类型**: 使用 `list_supported_providers` 确认支持\n4. **逐步配置**: 先使用 `setup_email_account` 自动配置\n\n## 📁 项目结构\n\n```\n├── index.js # MCP Server主程序\n├── package.json # 项目依赖配置\n├── README.md # 项目主文档\n├── CONFIG_GUIDE.md # 详细配置指南\n├── .gitignore # Git忽略文件\n├── 📁 配置模板/\n│ ├── mcp-x_config_v2.json # 通用配置模板\n│ └── mcp-x_config_multi.json # 多账户配置\n├── 📁 测试工具/\n│ ├── test-auto-config.js # 自动配置测试\n│ └── test-email-type.js # EMAIL_TYPE功能测试\n└── LICENSE # 开源许可证\n```\n\n### 🔑 核心文件说明\n\n- **`index.js`** - 主要的MCP服务器程序，包含所有邮件功能\n- **`CONFIG_GUIDE.md`** - 详细的配置指南，包含各种邮箱配置说明\n- **`mcp-x_config_v2.json`** - 通用配置模板，支持EMAIL_TYPE字段\n- **`test-auto-config.js`** - 测试自动配置功能的脚本\n- **`test-email-type.js`** - 验证EMAIL_TYPE字段功能的测试脚本\n\n## 🔐 安全注意事项\n\n1. **保护授权码**: 不要将授权码提交到版本控制系统\n2. **使用环境变量**: 推荐使用环境变量存储敏感信息\n3. **定期更新**: 定期更新授权码和检查安全设置\n4. **权限控制**: 确保只有授权用户可以访问MCP服务器\n\n## 📞 技术支持\n\n### 📖 文档资源\n- 📋 **[CONFIG_GUIDE.md](./CONFIG_GUIDE.md)** - 完整配置指南\n- 🔧 **测试工具** - 使用 `test-auto-config.js` 和 `test-email-type.js`\n- 🛠️ **内置诊断** - 使用 `test_email_connection` 工具\n\n### 🌐 官方文档\n- [网易邮箱客户端设置](https://help.mail.163.com/faqDetail.do?code=d7a5dc8471cd0c0e8b4b8f4f8e49998b374173cfe9171305fa1ce630d7f67ac2a5feb28b66796d3b)\n- [腾讯企业邮箱配置](https://open.work.weixin.qq.com/help2/pc/19886?person_id=1)\n- [QQ邮箱帮助中心](https://kf.qq.com/product/tx_mail.html)\n- [Gmail设置指南](https://support.google.com/mail/answer/7126229)\n\n### 🤝 贡献指南\n欢迎提交 Issue 和 Pull Request 来改进这个项目！\n\n- 🐛 **报告Bug**: 请详细描述问题和复现步骤\n- 💡 **功能建议**: 欢迎提出新的邮箱支持需求\n- 📝 **文档改进**: 帮助完善使用文档\n\n### 📊 项目状态\n- ✅ **生产就绪**: 支持8大主流邮箱服务商\n- 🔄 **持续更新**: 根据用户反馈不断改进\n- 🛡️ **安全保障**: 支持SSL/TLS加密和授权码认证\n\n## 📄 许可证\n\nMIT License - 详见 [LICENSE](./LICENSE) 文件\n\n---\n\n## 🎉 快速测试\n\n配置完成后，可以在MCP客户端中测试功能：\n\n**发送测试邮件：**\n```\n请发送一封测试邮件到 test@example.com，主题为\"MCP测试邮件\"，内容为\"Hello from Universal Email MCP!\"\n```\n\n**获取邮件列表：**\n```\n请获取最近3天的邮件列表，限制10封邮件\n```\n\n**测试连接：**\n```\n请测试邮箱连接状态\n```\n\n如果一切配置正确，所有功能都应该正常工作！🚀 ","readmeFilename":"README.md","_rev":"1-b9b8cb8f9d7439f682c8dfaeee36b9cf"}