MailboxValidator MCP-Server

Dies ist eine einfache Implementierung eines Model Context Protocol (MCP)-Servers für die MailboxValidator-API. Er gibt das Validierungsergebnis für eine E-Mail-Adresse zurück.

Funktionen

• Umfassende E-Mail-Validierung: Überprüfung einer E-Mail-Adresse, um festzustellen, ob sie erreichbar ist, durch Prüfung von Syntax, DNS, MX-Server, hohem Risiko, Unterdrückungslisten und mehr.

• Wegwerf-E-Mail: Überprüfung einer E-Mail-Adresse, um festzustellen, ob sie von einem Anbieter für temporäre/Wegwerf-E-Mails stammt.

• Kostenlose E-Mail: Überprüfung einer E-Mail-Adresse, um festzustellen, ob sie von einem kostenlosen E-Mail-Anbieter stammt.

Voraussetzung

Dieser MCP-Server erfordert einen API-Schlüssel. Sie können sich auch für einen kostenlosen API-Schlüssel anmelden und bis zu 300 Abfragen pro Monat nutzen.

Das Setup verwendet außerdem Node.js und npm, die auf der Node.js-Website heruntergeladen werden können.

Einrichtung

Befolgen Sie die Schritte, um diesen MCP-Server mit Claude Desktop zu verwenden:

1. Laden Sie das Repository lokal herunter.

2. Führen Sie die folgenden Befehle im Projektordner aus, um Abhängigkeiten zu installieren und den Server zu erstellen.

npm install
npm run build

3. Stellen Sie sicher, dass Sie Claude Desktop installiert haben. Falls nicht, laden Sie es bitte hier für Windows- und MacOS-Benutzer herunter oder folgen Sie dieser Anleitung für Linux-Benutzer.

4. Öffnen Sie die claude_desktop_config.json in einem Editor Ihrer Wahl. Falls Sie noch keine haben, folgen Sie dieser Anleitung, um eine zu erstellen.

5. Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
      ],
      "env": {
        "MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

6. Denken Sie daran, den Pfad für die index.js durch Ihren tatsächlichen Pfad zum MailboxValidator MCP-Server auf Ihrem lokalen Computer zu ersetzen.

7. Um Ihren API-Schlüssel zu erhalten, melden Sie sich einfach an in Ihrem Dashboard und rufen Sie ihn dort ab. Ersetzen Sie <YOUR_API_KEY> im obigen Beispiel durch Ihren tatsächlichen API-Schlüssel.

8. Starten Sie Claude Desktop nach dem Speichern der Änderungen neu. Er sollte nun im Menü Search and tools erscheinen.

Verwendung

Geben Sie einfach Ihre Anfrage zur E-Mail-Adresse in einem Chat in Claude Desktop ein. Einige Beispielanfragen wären:

• Ist (email) eine gültige E-Mail-Adresse?

• Ist (email) eine gefälschte E-Mail?

• Ist (email) eine kostenlose E-Mail?

In Claude Desktop generiert das Modell automatisch die Ausgabe basierend auf dem vom MailboxValidator MCP-Server zurückgegebenen Ergebnis.

Umgebungsvariable

MAILBOXVALIDATOR_API_KEY

Der kostenlose MailboxValidator API-Schlüssel ermöglicht es Ihnen, bis zu 300 E-Mails pro Monat abzufragen. Wenn Sie mehr benötigen, können Sie sich für einen kostenpflichtigen API-Plan anmelden.

Tool

validate_email

Beschreibung Validiert die angegebene E-Mail-Adresse. Es hilft Benutzern festzustellen, ob eine E-Mail-Adresse potenziell erreichbar ist, indem Syntax, DNS, MX-Server, Wegwerf-Listen und mehr überprüft werden.

Argumente email (str): Die zu validierende E-Mail-Adresse.

Rückgabewerte Ein JSON-String, der die Validierungsdaten enthält. Das Ergebnis umfasst die folgenden Felder:

• Syntax: Überprüft, ob die E-Mail-Adresse dem Standardformat entspricht.

• DNS & MX-Server: Überprüft, ob für die Domain ein MX-Server im DNS angegeben ist.

• Netzwerk & Konnektivität: Versucht eine Verbindung zum MX-Server herzustellen, um sicherzustellen, dass er betriebsbereit ist.

• Greylisting: Überprüft, ob der MX-Server Greylisting verwendet, was dazu führen könnte, dass an diese Adresse gesendete E-Mails abgewiesen werden.

• Wegwerf-Liste: Überprüft, ob die E-Mail-Domain von einem Anbieter für temporäre oder Wegwerf-E-Mails stammt.

• Hohes Risiko & Unterdrückungsliste: Überprüft, ob der E-Mail-Benutzername ein hohes Risiko darstellt oder ob die E-Mail-Adresse in einer Unterdrückungsliste gefunden wurde.

• Sonstiges: Überprüft den Reputations-Score für die E-Mail und vieles mehr..

Wenn die Anfrage fehlschlägt, gibt das Tool eine Fehlermeldung als String zurück.

check_disposable_email

Beschreibung Überprüft, ob die angegebene E-Mail-Adresse von einem Anbieter für Wegwerf-E-Mails stammt.

Argumente email (str): Die zu überprüfende E-Mail-Adresse.

Rückgabewerte Ein JSON-String, der die Daten zur Wegwerf-E-Mail enthält. Das Ergebnis umfasst die folgenden Felder:

• Wegwerf-Liste: Überprüft, ob die E-Mail-Domain von einem Anbieter für temporäre oder Wegwerf-E-Mails stammt.

Wenn die Anfrage fehlschlägt, gibt das Tool eine Fehlermeldung als String zurück.

check_free_email

Beschreibung Überprüft, ob die angegebene E-Mail-Adresse von einem kostenlosen E-Mail-Anbieter stammt.

Argumente email (str): Die zu überprüfende E-Mail-Adresse.

Rückgabewerte Ein JSON-String, der die Daten zur kostenlosen E-Mail enthält. Das Ergebnis umfasst die folgenden Felder:

• Liste kostenloser E-Mails: Überprüft, ob die E-Mail-Domain von einem kostenlosen E-Mail-Anbieter stammt.

Wenn die Anfrage fehlschlägt, gibt das Tool eine Fehlermeldung als String zurück.

Lizenz

Siehe die LICENSE-Datei.