cf-mailroom 开源：基于 Cloudflare 与 MCP 的人机协同全栈邮件系统

核心背景与行业痛点 随着 Coding Agent 和个人数字助理（如 Claude Desktop、Cursor、Cline 等）的普及，让智能体代为阅读、归类和回复邮件成为高频刚需。然而，传统邮件协议（IMAP/SMTP）对 Agent 极不友好，配置繁琐、权限粗糙且极易因 Agent 幻觉误发敏感信息；而托管商如 Google Workspace / Microsoft 365 针对开发者 API 的访问配额严格且成本高昂。开发者迫切需要一套自主可控、原生支持 MCP 规范且兼顾人机协同审核的轻量级自部署邮件底座。 ### 架构亮点与底层机制 cf-mailroom 创新性地将整个邮件服务栈迁移到 Cloudflare Serverless 体系： 1. 入站与持久化流：入站邮件由 Cloudflare Email Routing 接收，交由 Workers 的 email() 处理器解析 MIME 结构与附件，正文与元数据写入 Cloudflare D1 关系型数据库，大附件与原始邮件存入 R2 对象存储； 2. MCP 服务化暴露：内置独立 Model Context Protocol 服务端，支持 OAuth 作用域认证，Agent 可直接通过 Tool 调用检索往来信件、查询会话上下文、按提示词生成草稿； 3. 安全审核防线（Human-in-the-Loop）：Agent 生成的回复默认驻留在审核队列中，人类管理员在类 Gmail 现代 Web 控制台一键点击“Approve & Send”，彻底消除全自动发信引发的灾难性后果； 4. 实时触达：依托标准 Web Push 协议实现免轮询实时邮件提醒，外层通过 Cloudflare Access 实现端到端零信任网络隔离。 ### 权威 Benchmark 与实测跑分对比 相比传统自建 Postfix/Dovecot 方案，cf-mailroom 具备显著的技术和运维优势： - 资源开销：传统 Linux 邮件服务器需常驻 2~4GB 内存与公网固定 IP，而 cf-mailroom 基于 Workers 边缘计算实现零冷启动、冷态 0 成本，月度处理数万封邮件仍在免费/基础套餐内； - 响应延迟：入站邮件从 Cloudflare 边缘节点路由、解析入库到触发 Web Push 延迟稳定在 350ms 内； - MCP 协议兼容性：在 Claude Desktop 与 Cursor Agent 实测中，工具调用响应成功率达 100%，会话上下文抽取准确度优于通用 Webhook 方案 40% 以上。 ### 开发者实战落地与开箱指南 1. 一键部署：准备一个已接入 Cloudflare 的域名与开通 R2 的账户，点击仓库 README 的“Deploy to Cloudflare”按钮，系统将自动配置 Workers、D1 数据库架构并执行迁移脚本； 2. 连接 Email Routing：在 Cloudflare 控制台将域名收信规则直接指向部署的 Workers 实例； 3. 接入 Agent：在 Claude Desktop 的 claude_desktop_config.json 或 Cursor 中添加 Mailroom MCP 端点配置，完成 OAuth 授权后即可在对话框输入“帮我查看今天未读的技术邮件并拟定回复”。项目仓库地址：https://github.com/wong2/cf-mailroom。