邮件测试与模拟工具

MailSandbox——面向开发人员的电子邮件测试与模拟

叉子 邮件 添加Postmark API仿真和用于AI辅助调试的MCP服务器。
受到原创作品的启发和感激 邮件 和 MailHog。参见 鸣谢.

Repository • Installation • Usage • Postmark API • MCP Server

邮件沙盒 是一个小型、快速、低内存、零依赖、多平台 电子邮件测试工具&API 对于开发者来说。
它提供了SMTP服务器、现代web界面、REST API、Postmark API仿真，以及用于AI驱动工作流的MCP服务器。

特性

• 🚀 轻量级 --单个静态二进制或多拱形Docker镜像
• 🌐 现代Web用户界面 --查看HTML、源代码、页眉、附件、搜索和筛选
• 📬 SMTP和POP3服务器 --STARTTLS/SSL/TLS、身份验证、转发、中继
• 🔍 测试工具 --HTML检查、链接检查、垃圾邮件评分、截图、移动预览
• 🏷 标记和过滤 --手动或自动（包括加地址）
• ⚡ 演出 --100-200封电子邮件/秒，自动修剪（默认500封电子邮件）
• 🧪 混沌模式 --注入SMTP错误以测试弹性
• 🔔 集成 - 网上挂钩，浏览器通知， List-Unsubscribe 验证
• 🆕 Postmark API模拟 --在开发过程中替换邮戳
• 🤖 MCP服务器 --人工智能助手（例如Claude Code）可以列出、搜索和分析消息

安装

web UI运行在 http://0.0.0.0:8025 SMTP已打开 0.0.0.0:1025.

脚本（Linux和macOS）

sudo sh < <(curl -sL https://raw.githubusercontent.com/btafoya/mailsandbox/main/install.sh)

静态二进制

下载自 发布，重命名为 mailsandbox，并添加到 $PATH.

码头工人

docker run -d --name mailsandbox   -p 8025:8025 -p 1025:1025   btafoya/mailsandbox

用法

列出选项：

mailsandbox -h

邮政标记API仿真

启用Postmark API模拟：

mailsandbox --postmark-api --postmark-token "your-secret-token"

环境变量：

export MP_POSTMARK_API=true
export MP_POSTMARK_TOKEN=your-secret-token
mailsandbox

示例：Node.js

const postmark = require("postmark");
const client = new postmark.ServerClient("your-secret-token");
client.apiUrl = "http://localhost:8025";
client.sendEmail({ From:"a@x.com", To:"b@y.com", Subject:"Test", TextBody:"Hello" });

终点：

• POST /email
• POST /email/batch
• POST /email/withTemplate

用于AI助手的MCP服务器

启用MCP服务器：

mailsandbox --mcp-server --mcp-transport stdio

环境变量：

export MP_MCP_SERVER=true
export MP_MCP_TRANSPORT=stdio

Docker与MCP

docker build -t mailsandbox-with-mcp .
docker run -d --name mailsandbox   -p 127.0.0.1:8025:8025 -p 1025:1025   -e MP_MCP_SERVER=true   -e MP_MCP_TRANSPORT=stdio   -e MP_POSTMARK_API=true   -e MP_POSTMARK_TOKEN=dev-token-123   mailsandbox-with-mcp

MCP工具

• list_messages --列出/过滤电子邮件
• get_message --检索完整邮件
• search_messages --高级搜索
• analyze_message --HTML、链接、垃圾邮件评分

迁移指南

• 二进制名称已重命名 mailsandbox；如果愿意，可以创建符号链接 mailpit.
• 默认端口不变：HTTP 8025，SMTP 1025.
• API：REST API保持不变；邮戳和MCP是可选的。
• Docker：使用分叉镜像实现MCP/Postmark功能。

致谢与确认

• 邮件 --由Axel Lenferna de la Motte和撰稿人撰写。原创项目，积极开发。
• MailHog --mainer电子邮件测试工具的最初灵感。
• 邮件沙盒 -由Brian Tafoya维护，添加Postmark API仿真和MCP服务器支持。

许可证

MailSandbox继承了Mailpit的上游许可证。看 LICENSE 了解详情。

明星历史