MailDevMcp

English | 日本語

mcp-name: io.github.pierre3/maildev-mcp

一个用于 MailDev 的 MCP（模型上下文协议） 服务器。
直接在你的 AI 驱动编辑器或 MCP 客户端中管理 MailDev Docker 容器并检查收到的电子邮件。

该服务器面向本地开发和测试自动化场景，适用于 MCP 客户端需要执行以下操作的场景：

• 启动或停止 MailDev 容器

• 检查收件箱内容

• 在触发应用程序行为后等待电子邮件

• 检查 HTML 正文和附件

• 逐字节验证附件的完整性

安装

作为全局 .NET 工具安装：

dotnet tool install -g MailDevMcp

安装后，maildev-mcp 命令即可使用。

Related MCP server: @injaan.dev/ms365-email-cli-mcp

MCP 客户端配置

将以下内容添加到你的 MCP 客户端设置中（例如 Claude Desktop、VS Code 等）：

{
  "mcpServers": {
    "maildev-mcp": {
      "command": "maildev-mcp",
      "env": {
        "MAILDEV_API_PORT": "1080"
      }
    }
  }
}

环境变量

典型工作流程

1. 调用 StartMaildev 启动本地 MailDev 容器

2. 触发你的应用程序发送电子邮件

3. 如果投递是异步的，请调用 WaitForEmail

4. 使用 ListEmails、SearchEmails 或 GetEmail 检查结果

5. 当需要更深入的验证时，使用 GetEmailHtml、GetAttachmentContent 或 VerifyAttachment

6. 使用 DeleteEmail、DeleteAllEmails 或 StopMaildev 进行清理

可用工具

工具行为说明

• StartMaildev

  • 支持自定义 SMTP 和 API 端口

  • 支持可选的 SMTP 身份验证

  • 将空凭据或仅包含空格的凭据视为禁用身份验证

  • 支持使用生成的自我签名证书进行 TLS

• GetEmail 和 ListEmails

  • 将缺失或空主题显示为 (no subject)

  • 将缺失的地址列表显示为 (none)

• WaitForEmail

  • 轮询 MailDev，直到匹配的电子邮件到达或达到超时时间

  • 在轮询期间发生瞬时 MailDev 连接失败时，在返回的消息中报告该错误

• VerifyAttachment

  • 接受 Base64 编码的原始负载

  • 逐字节比较收到的附件

  • 报告完全匹配、大小不匹配或内容不匹配

要求和假设

• 必须安装 Docker，并且该 MCP 服务器运行的机器上必须可用

• 通过 localhost 上的 HTTP API 访问 MailDev

• MCP 客户端中配置的 API 端口必须与 Docker 公开的 MailDev API 端口匹配

先决条件

• .NET 10 SDK 或更高版本

• Docker（用于运行 MailDev 容器）

从源代码构建

git clone https://github.com/pierre3/MailDevMcp.git
cd MailDevMcp
dotnet pack -c Release
dotnet tool install -g --add-source ./bin/Release MailDevMcp

许可证

MIT