MailSandbox（btafoya/mailsandbox）是 Mailpit 的一个分支，定位为开发者使用的邮件测试与模拟工具。其核心是用一个快速、低内存、零依赖、跨平台的工具替代在开发中误发真实邮件的问题，提供 SMTP 服务器、现代 Web 界面、REST API、Postmark API 模拟以及用于 AI 辅助工作流的 MCP 服务器。
用途 主要用于本地或开发环境拦截、检查和调试应用发送的邮件，避免真实投递。通过 Postmark API 模拟，可在开发阶段直接替换 Postmark 进行测试；通过 MCP 服务器，AI 助手（如 Claude Code）能够列出、搜索和消息分析邮件，辅助调试。
主要能力
- 轻量：单个静态二进制或多架构 Docker 镜像。
- 现代 Web UI：查看 HTML、源码、头部、附件，支持搜索与过滤。
- 服务器支持：SMTP 与 POP3 服务器，支持 STARTTLS/SSL/TLS、认证、转发、中继。
- 测试工具：HTML 检查、链接检查、垃圾邮件评分、截图、移动预览。
- 标签与过滤：手动或自动（含加号寻址）。
- 性能：每秒 100–200 封邮件，自动清理（默认保留 500 封）。
- 混沌模式：注入 SMTP 错误以测试韧性。
- 集成：Webhook、浏览器通知、List-Unsubscribe 验证。
- Postmark API 模拟：开发期间可直接替代 Postmark。
- MCP 服务器：AI 助手可列出、搜索和分析邮件，提供 list_messages、get_message、search_messages、analyze_message 等工具。
使用方式 Web UI 默认运行在 http://0.0.0.0:8025，SMTP 默认在 0.0.0.0:1025。可从 releases 下载后重命名为 mailsandbox 并加入 $PATH。Postmark API 模拟与 MCP 服务器需通过环境变量启用（具体变量暂未提供细节）。Docker 中使用 fork 镜像以支持 MCP/Postmark 功能。迁移时二进制名称改为 mailsandbox，可创建 mailpit 符号链接；默认 HTTP 8025、SMTP 1025 端口不变；REST API 不变；Postmark 与 MCP 为选择性启用。
适用场景 开发与测试环境中邮件功能调试、自动化邮件流程验证、Postmark 集成开发、以及借助 AI 助手进行邮件内容分析与问题定位。
限制 资料未提供具体系统要求、环境变量完整列表、性能边界、安全性细节或价格信息，这些内容暂未提供。该项目继承 Mailpit 的上游许可证，详情见 LICENSE。
