MailDevMcp

English | 日本語

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

MailDev 用の MCP (Model Context Protocol) サーバーです。
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 エンコードされた元のペイロードを受け入れます

  • 受信した添付ファイルをバイト単位で比較します

  • 完全一致、サイズ不一致、またはコンテンツ不一致のいずれかを報告します

要件と前提条件

• この MCP サーバーが実行されるマシンに Docker がインストールされ、利用可能である必要があります

• MailDev は localhost 上の HTTP API を介してアクセスされます

• 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