Maildev Mcp

io.github.pierre3由 GitHub 帳號 pierre3 發布v1.0.1更新於 Oct 24, 2026

MailDev MCP server. Manage Docker containers and inspect emails from your AI editor or MCP client.

已驗證STDIO僅桌面開發者工具溝通與協作

概覽

AI 產生的概覽

針對 MailDev 的在地 MCP 伺服器，讓助理啟動與停止 MailDev Docker 容器，並檢視、搜尋、等待與驗證其收到的郵件。

可以做什麼
啟動、停止並檢查本機 MailDev Docker 容器的狀態，可設定 SMTP 與 API 連接埠、選用 SMTP 驗證，以及使用自簽憑證的 TLS。依主旨、寄件者或收件者列出、搜尋與讀取收到的郵件，包含 HTML 內容與附件資訊。等待符合條件的新郵件送達，適合在觸發應用程式寄信後使用。刪除單封郵件或清空整個收件匣。以 Base64 取得附件內容，並將收到的附件與原始資料逐位元組比對驗證。
適用情境
適用於本機開發與測試自動化情境：助理需要操作 MailDev 實例，啟動它、觸發應用程式寄信、等待投遞，然後檢查或驗證郵件及其附件。不適合正式環境的郵件處理。
執行需求
以本機程序執行；此套件為 .NET 全域工具，需要 .NET 10 SDK 或更新版本。同一台機器上必須安裝並可使用 Docker。透過 localhost 上的 HTTP API 存取 MailDev；環境變數 MAILDEV_API_PORT 設定 API 連接埠（預設 1080），且必須與 Docker 對外暴露的連接埠一致。
安裝前請注意
StartMaildev 會建立與移除 Docker 容器，並接受選用的 SMTP 憑證；空白或僅含空白的憑證會被視為關閉驗證。DeleteEmail 與 DeleteAllEmails 會永久刪除收件匣中的郵件。TLS 使用產生的自簽憑證，用戶端可能不信任。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Maildev Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MailDevMcp

English | 日本語

[CI] [NuGet]

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

An MCP (Model Context Protocol) server for MailDev.
Manage MailDev Docker containers and inspect received emails directly from your AI-powered editor or MCP client.

This server is intended for local development and test automation scenarios where an MCP client needs to:

  • start or stop a MailDev container
  • inspect inbox contents
  • wait for emails after triggering application behavior
  • inspect HTML bodies and attachments
  • verify attachment integrity byte-for-byte

Installation

Install as a global .NET tool:

sh
dotnet tool install -g MailDevMcp

After installation, the maildev-mcp command becomes available.

MCP Client Configuration

Add the following to your MCP client settings (e.g. Claude Desktop, VS Code, etc.):

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

Environment Variables

VariableDefaultDescription
MAILDEV_API_PORT1080Port number for the MailDev REST API

Typical Workflow

  1. Call StartMaildev to launch a local MailDev container
  2. Trigger your application to send an email
  3. Call WaitForEmail if delivery is asynchronous
  4. Use ListEmails, SearchEmails, or GetEmail to inspect the result
  5. Use GetEmailHtml, GetAttachmentContent, or VerifyAttachment when deeper validation is needed
  6. Clean up with DeleteEmail, DeleteAllEmails, or StopMaildev

Available Tools

ToolDescription
StartMaildevStart the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS
StopMaildevStop and remove the MailDev Docker container
MaildevStatusCheck the running status of MailDev
ListEmailsRetrieve the list of received emails
GetEmailGet the details of an email by ID, including attachment information
GetEmailHtmlGet the HTML body of an email by ID
SearchEmailsSearch received emails by subject, sender, or recipient
DeleteEmailDelete a single email by ID
DeleteAllEmailsDelete all received emails
WaitForEmailWait until a new email matching given criteria arrives (useful for test automation)
GetAttachmentContentGet the raw Base64-encoded content of an email attachment
VerifyAttachmentVerify that an email attachment matches the original data by byte-by-byte comparison

Tool Behavior Notes

  • StartMaildev
    • Supports custom SMTP and API ports
    • Supports optional SMTP authentication
    • Treats empty or whitespace-only credentials as authentication disabled
    • Supports TLS with a generated self-signed certificate
  • GetEmail and ListEmails
    • Render missing or empty subjects as (no subject)
    • Render missing address lists as (none)
  • WaitForEmail
    • Polls MailDev until a matching email arrives or the timeout is reached
    • Reports transient MailDev connection failures in the returned message when they occur during polling
  • VerifyAttachment
    • Accepts a Base64-encoded original payload
    • Compares the received attachment byte-by-byte
    • Reports either exact match, size mismatch, or content mismatch

Requirements and Assumptions

  • Docker must be installed and available on the same machine where this MCP server runs
  • MailDev is accessed through its HTTP API on localhost
  • The configured API port in the MCP client must match the MailDev API port exposed by Docker

Prerequisites

Building from Source

sh
git clone https://github.com/pierre3/MailDevMcp.gitcd MailDevMcpdotnet pack -c Releasedotnet tool install -g --add-source ./bin/Release MailDevMcp

License

MIT

來源：README.md，提交 15c2a39

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分