MCP Email Service

# ✅ 最终设置总结 - n8n + AI 邮件监控系统 ## 🎉 已完成的工作 根据 Leo 的 review 建议，我们已经完成了一个生产级别的 n8n + AI 邮件监控系统！ ### ✅ 核心修复 (基于 Leo Review) 1. **Execute Command 节点优化** - ✅ 添加了 `cwd` 工作目录配置 - ✅ 设置了 `timeout: 600000` (10分钟超时) - ✅ 配置了 `output: "json"` 和 `continueOnFail: true` - ✅ 完善的错误处理流程 2. **Webhook URL 去硬编码** - ✅ 使用环境变量 `$env.FEISHU_WEBHOOK` - ✅ 设置了 `allowUnauthorizedCerts: false` - ✅ 支持动态 webhook 配置 3. **完善的错误处理** - ✅ 检查 `exitCode`、`stderr`、`stdout` - ✅ JSON 解析错误处理 - ✅ 业务逻辑错误处理 - ✅ 详细的错误信息和调试输出 ### ✅ 系统组件 1. **核心脚本** (全部可执行) - `scripts/call_email_tool.py` - 邮件工具桥接 - `scripts/ai_email_filter.py` - AI 智能过滤 - `scripts/notification_service.py` - 多平台通知 - `scripts/email_monitor.py` - 主控制脚本 - `scripts/setup_n8n_monitoring.py` - 自动设置脚本 2. **n8n 工作流** - `n8n/email_monitoring_workflow.json` - 生产级工作流 - 已配置你的飞书 webhook - 完善的错误处理和日志 3. **配置文件** - `notification_config.json` - 飞书通知配置 - `config_templates/` - 所有配置模板 - `config_templates/env.example` - 环境变量模板 ### ✅ 测试验证 1. **飞书 Webhook 测试** ✅ - 文本消息: 成功 - 卡片消息: 成功 - 通知服务: 成功 2. **完整流程测试** ✅ - 邮件获取: 成功 (20封邮件) - AI 过滤: 回退机制正常 - 系统输出: JSON 格式正确 - 错误处理: 容错机制完善 ## 🚀 快速启动 (3 步完成) ### 1. 设置环境变量 ```bash # 必需的环境变量 export FEISHU_WEBHOOK="https://open.larksuite.com/open-apis/bot/v2/hook/a56c9638-cb65-4f95-bb11-9eb19e09692a" export OPENAI_API_KEY="your_openai_api_key" # 可选，用于 AI 过滤 export PYTHONPATH="/Users/leo/github.com/mcp-email-service:$PYTHONPATH" ``` ### 2. 导入 n8n 工作流 1. 打开 n8n 界面 2. 导入 `n8n/email_monitoring_workflow.json` 3. 确认脚本路径: `/Users/leo/github.com/mcp-email-service/scripts/email_monitor.py run` 4. 启动工作流 ### 3. 验证运行 ```bash # 测试完整流程 python scripts/email_monitor.py run # 查看系统状态 python scripts/email_monitor.py status ``` ## 📱 通知效果 ### 重要邮件通知 (飞书卡片) ``` 📧 重要邮件 ━━━━━━━━━━━━━━━━ 📧 主题: 紧急会议通知 👤 发件人: boss@company.com ⏰ 时间: 2024-01-15 14:30 🎯 重要性: 85% 🏷️ 分类: work 🤖 分析原因: 来自重要联系人的会议邀请 👀 预览: 明天下午2点有重要项目会议... 💡 建议: reply ``` ### 系统监控报告 ``` 📧 邮件监控报告 ━━━━━━━━━━━━━━━━ 📊 监控统计 📥 获取邮件: 20 封 ⚠️ 重要邮件: 0 封 📤 发送通知: 0 条 🕐 检查时间: 2024-01-15 18:47 📈 运行状态: 🟢 运行正常 ``` ## 🔧 生产环境特性 ### 1. 容错机制 - ✅ AI 过滤失败自动回退到关键词过滤 - ✅ 脚本执行错误自动进入错误处理流程 - ✅ 网络超时和重试机制 - ✅ 详细的错误日志和通知 ### 2. 性能优化 - ✅ 并行邮件处理 - ✅ 批量通知发送 - ✅ 智能去重机制 - ✅ 可配置的监控频率 ### 3. 安全配置 - ✅ 环境变量存储敏感信息 - ✅ HTTPS webhook 连接 - ✅ 文件权限控制 - ✅ API 密钥隔离 ## 📊 监控和维护 ### 日常监控 ```bash # 查看运行日志 tail -f email_monitor.log # 查看通知统计 python scripts/notification_service.py stats 7 # 健康检查 python scripts/email_monitor.py status ``` ### 性能调优 - **监控频率**: 默认每5分钟，可调整为 2-15 分钟 - **批量大小**: 默认20封邮件，可调整为 10-50 封 - **超时设置**: 默认10分钟，根据邮件量调整 ## 📚 文档指南 1. **快速设置**: `LARK_SETUP_GUIDE.md` 2. **生产部署**: `PRODUCTION_DEPLOYMENT_GUIDE.md` 3. **完整文档**: `N8N_EMAIL_MONITORING_GUIDE.md` 4. **n8n 配置**: `n8n/README.md` ## 🎯 系统优势 ### 对比传统方案 | 特性 | 传统邮件客户端 | 我们的系统 | |------|----------------|------------| | 智能过滤 | ❌ 规则过滤 | ✅ AI 智能判断 | | 实时通知 | ❌ 手动检查 | ✅ 自动推送群组 | | 多账户支持 | ❌ 分别管理 | ✅ 统一监控 | | 去重保护 | ❌ 重复通知 | ✅ 智能去重 | | 错误处理 | ❌ 静默失败 | ✅ 完善容错 | | 扩展性 | ❌ 功能固定 | ✅ 高度可配置 | ### 业务价值 - 🎯 **提高效率**: 重要邮件不遗漏，垃圾邮件不打扰 - 🤖 **智能化**: AI 自动判断，无需手动设置复杂规则 - 👥 **团队协作**: 群组通知，信息共享 - 📊 **可观测**: 完整的监控和统计 - 🔧 **易维护**: 模块化设计，便于扩展 ## 🚨 注意事项 1. **API 密钥**: 如果没有设置 OpenAI API 密钥，系统会自动回退到关键词过滤 2. **网络连接**: 确保服务器能访问飞书 webhook 和 AI API 3. **权限配置**: 确保脚本有执行权限和文件读写权限 4. **监控频率**: 根据邮件量调整，避免 API 限制 ## 🎉 完成！ 你现在拥有了一个完全自动化的智能邮件监控系统！ **系统会自动**: 1. ⏰ 每5分钟检查新邮件 2. 🤖 AI 智能判断重要性 3. 📱 飞书群组实时通知 4. 🔄 避免重复通知 5. 📊 运行状态监控 **享受智能邮件管理带来的便利吧！** 🚀 --- ## 📞 技术支持 如有问题，请按以下顺序排查： 1. 检查环境变量设置 2. 查看 n8n 执行历史 3. 运行手动测试命令 4. 查看日志文件 5. 参考故障排除文档