DearAgent：让 AI 代理拥有自托管邮箱的 MCP 服务器

DearAgent 是一个自托管在 Cloudflare Workers 上的 AI 代理邮箱 API，邮件存 D1、附件存 R2，定位为开源的 AgentMail 替代品，并通过 Worker 上的 /mcp 端点暴露无状态 Streamable HTTP MCP 服务器。

适合谁

• 适合想让 AI 代理拥有真实收件能力的开发者：典型流程是创建收件箱、等待验证邮件、读取验证链接。
• 前提明确：需要 Cloudflare 账号、一个用于 Cloudflare Email Routing 的专用顶级域名、Node 20+ 并执行 npx wrangler login。接收邮件免费；只有发送邮件才需要 Workers Paid。
• API 与 MCP 使用同一个 API_KEY 作为唯一 bearer 令牌，一把钥匙拥有全部权限（单租户），不适合需要细粒度权限隔离的多用户场景。
• 不适合的情况：没有自己的域名、无法接受自托管部署与维护责任、或需要多租户权限隔离的用户。官方证据未说明的方面（如数据保留、删除策略）属未知，请自行确认。

3 分钟完成第一次尝试

官方推荐的唯一主路径是克隆仓库后运行交互式安装脚本，它会自动配置 D1、R2、密钥、Email Routing/Sending，完成部署并创建 catch-all 规则：

git clone https://github.com/panda-sandeep/dearagent && cd dearagent
npm install
npm run setup

前提：已 npx wrangler login 登录 Cloudflare，域名已可用于 Email Routing。脚本会引导设置必需的 API_KEY（也可用 npx wrangler secret put API_KEY 设置），该密钥是 API 和 MCP 的唯一 bearer 令牌。

首次调用建议使用低风险的只读工具 list_inboxes：在 MCP 客户端中配置指向 Worker 的 /mcp 端点并带上 bearer 密钥后，调用 list_inboxes。能返回收件箱列表即说明部署和鉴权成功。注意这是自托管服务，不属于远端第三方托管写入；create_inbox 会写入你自己的 D1 数据库。

如果你只想接收邮件，无需 Workers Paid；只有在准备调用 send_message 发送邮件时，才确认已开通 Workers Paid，因为发送会产生真实的对外邮件（不可由 MCP 层撤销，需按 Email Sending 的实际行为评估）。

使用案例

案例一：让代理自动完成注册验证。调用 create_inbox 创建一个收件箱，把该地址填入目标网站注册表单，然后用 wait_for_message 等待验证邮件到达，再读取邮件内容中的验证链接。这是官方描述的典型流程；工具返回的是你自建服务中的真实邮件内容。

案例二：检索历史邮件。调用 search_messages 按关键词搜索，或用 list_threads / get_thread 查看会话、get_message 读取具体邮件、get_attachment 获取附件。这些都是读取你 D1/R2 中已有数据的查询类操作，适合排查代理此前收到的邮件。

其余工具（如 send_message、reply_to_message、forward_message、list_webhooks、create_webhook）在证据中被列为可用工具，但各自参数细节证据未给出，使用前请以仓库 README 为准。

使用边界

• 读写性质：list_*、get_*、search_messages、wait_for_message 属查询类；create_inbox、create_webhook、send_message、reply_to_message、forward_message 会写入数据或产生真实外发动作，调用前应确认。
• 凭证与数据：单一 API_KEY 即可完全访问，请妥善保管；所有邮件数据存放在你自己的 Cloudflare D1/R2 中。
• 副作用：发送邮件需要 Workers Paid 且会真实发出；官方未说明发送后的撤回机制，不能视为可撤销操作。
• 未知项：官方证据未说明邮件保留期限、删除工具、隐私处理细节，这些信息尚未确认，不构成无风险的结论。