MailDevMcp

Englisch | 日本語

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

Ein MCP (Model Context Protocol)-Server für MailDev.
Verwalten Sie MailDev-Docker-Container und prüfen Sie empfangene E-Mails direkt aus Ihrem KI-gestützten Editor oder MCP-Client.

Dieser Server ist für Szenarien der lokalen Entwicklung und Testautomatisierung gedacht, in denen ein MCP-Client Folgendes benötigt:

• einen MailDev-Container starten oder stoppen

• den Inhalt des Posteingangs prüfen

• nach dem Auslösen von Anwendungsverhalten auf E-Mails warten

• HTML-Inhalte und Anhänge prüfen

• die Integrität von Anhängen byteweise verifizieren

Installation

Als globales .NET-Tool installieren:

dotnet tool install -g MailDevMcp

Nach der Installation steht der Befehl maildev-mcp zur Verfügung.

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

MCP-Client-Konfiguration

Fügen Sie Folgendes zu Ihren MCP-Client-Einstellungen hinzu (z. B. Claude Desktop, VS Code usw.):

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

Umgebungsvariablen

Typischer Ablauf

1. Rufen Sie StartMaildev auf, um einen lokalen MailDev-Container zu starten.

2. Veranlassen Sie Ihre Anwendung, eine E-Mail zu senden.

3. Rufen Sie WaitForEmail auf, wenn der Versand asynchron erfolgt.

4. Verwenden Sie ListEmails, SearchEmails oder GetEmail, um das Ergebnis zu prüfen.

5. Verwenden Sie GetEmailHtml, GetAttachmentContent oder VerifyAttachment, wenn eine genauere Validierung erforderlich ist.

6. Räumen Sie mit DeleteEmail, DeleteAllEmails oder StopMaildev auf.

Verfügbare Tools

Hinweise zum Tool-Verhalten

• StartMaildev

  • Unterstützt benutzerdefinierte SMTP- und API-Ports

  • Unterstützt optionale SMTP-Authentifizierung

  • Behandelt leere oder nur aus Leerzeichen bestehende Anmeldedaten als deaktivierte Authentifizierung

  • Unterstützt TLS mit einem generierten selbstsignierten Zertifikat

• GetEmail und ListEmails

  • Stellt fehlende oder leere Betreffzeilen als (no subject) dar

  • Stellt fehlende Adresslisten als (none) dar

• WaitForEmail

  • Fragt MailDev wiederholt ab, bis eine passende E-Mail eintrifft oder das Zeitlimit erreicht ist

  • Meldet vorübergehende MailDev-Verbindungsfehler in der zurückgegebenen Nachricht, wenn sie während der Abfrage auftreten

• VerifyAttachment

  • Akzeptiert eine Base64-kodierte Original-Nutzlast

  • Vergleicht den empfangenen Anhang Byte für Byte

  • Meldet entweder exakte Übereinstimmung, Größenabweichung oder Inhaltsabweichung

Anforderungen und Annahmen

• Docker muss auf demselben Rechner installiert und verfügbar sein, auf dem dieser MCP-Server ausgeführt wird

• Auf MailDev wird über seine HTTP-API unter localhost zugegriffen

• Der im MCP-Client konfigurierte API-Port muss mit dem von Docker bereitgestellten MailDev-API-Port übereinstimmen

Voraussetzungen

• .NET 10 SDK oder höher

• Docker (zum Ausführen des MailDev-Containers)

Erstellen aus dem Quellcode

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

Lizenz

MIT