Mailmodo

mailmodo-mcp

Dies ist ein TypeScript-Projekt, das einen Message Control Protocol (MCP)-Server für die Mailmodo-Integration mit Claude Desktop und anderen MCP-unterstützten Clients implementiert.

Voraussetzungen

• Node.js (v20 oder höher empfohlen)
• npm (wird mit Node.js geliefert)

Installation

Installation über Smithery

So installieren Sie den Mailmodo Integration Server für Claude Desktop automatisch über Smithery :

Manuelle Installation

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

Erstellen des Projekts

Um den TypeScript-Code in JavaScript zu kompilieren, führen Sie Folgendes aus:

Dadurch wird ein dist -Verzeichnis erstellt, das die kompilierten JavaScript-Dateien enthält.

Ausführen des Projekts

Nach dem Erstellen können Sie das Projekt mit Folgendem ausführen:

Oder verwenden Sie das npm-Skript:

Claude Desktop-Konfiguration

Lokaler Start vom Code

Um dieses Projekt mit Claude Desktop zu konfigurieren, fügen Sie Ihren Claude Desktop-Einstellungen die folgende Konfiguration hinzu:

Vom Docker-Image ausführen

Von npx ausführen

Verbindung über Remote-Server herstellen

Stellen Sie sicher, dass Sie den Dateipfad im args -Array so anpassen, dass er mit Ihrem lokalen Projektverzeichnis übereinstimmt.

Entwicklung

So führen Sie das Projekt im Entwicklungsmodus mit automatischer Neukompilierung aus:

1. Installieren Sie ts-node und nodemon als Entwicklungsabhängigkeiten:

2. Fügen Sie Ihrem package.json ein Entwicklungsskript hinzu:

3. Führen Sie den Entwicklungsserver aus:

Projektstruktur

Tools und Ressourcen

Der Mailmodo MCP-Server bietet verschiedene Tools und Ressourcen für die Interaktion mit den Funktionen von Mailmodo. Hier ist eine umfassende Liste:

Ressourcen

1. Mailmodo-Vorlagen ( mailmodo://templates )
   • Gibt eine Liste aller verfügbaren E-Mail-Vorlagen im JSON-Format zurück
   • MIME-Typ: application/json
2. Mailmodo-Kampagnen ( mailmodo://campaigns )
   • Gibt eine Liste aller Kampagnen im JSON-Format zurück
   • MIME-Typ: application/json
3. Mailmodo-Kontaktlisten ( mailmodo://contact-lists )
   • Gibt alle Kontaktlisten im JSON-Format zurück
   • MIME-Typ: application/json

Werkzeuge

1. Benutzerdetails
   • Name: userDetails
   • Beschreibung: Alle Details eines Kontakts abrufen
   • Parameter:
     • email (Zeichenfolge): E-Mail-Adresse des Kontakts
2. Kampagnenbericht-Tool
   • Name: MailmodoCampainReportTool
   • Beschreibung: Erhalten Sie Kampagnenberichte, einschließlich Öffnungs-, Klick- und Übermittlungszahlen
   • Parameter:
     • campaignId (UUID): ID der Kampagne
     • fromDate (JJJJ-MM-TT): Startdatum für den Bericht
     • toDate (JJJJ-MM-TT): Enddatum für den Bericht
3. Aktuelles Datum/Uhrzeit
   • Name: currentDateTime
   • Beschreibung: Aktuelles Datum und Uhrzeit abrufen
   • Parameter: Keine
4. Ereignis senden
   • Name: sendEvent
   • Beschreibung: Senden Sie benutzerdefinierte Ereignisse mit E-Mail- und Ereigniseigenschaften
   • Parameter:
     • email (Zeichenfolge): E-Mail-Adresse des Kontakts
     • event_name (Zeichenfolge): Name des Ereignisses
     • ts (Zahl, optional): Zeitstempel
     • event_properties (Objekt, optional): Zusätzliche Ereigniseigenschaften
5. Kontaktlistenverwaltung
   • Kontakt zur Liste hinzufügen
     • Name: addContactToList
     • Beschreibung: Einen einzelnen Kontakt zu einer Liste hinzufügen
     • Parameter:
       • email (Zeichenfolge): E-Mail des Kontakts
       • listName (Zeichenfolge): Name der Liste
       • data (Objekt, optional): Kontakteigenschaften
       • Verschiedene optionale Felder für Kontaktmetadaten
   • Massenhinzufügen von Kontakten
     • Name: addBulkContactToList
     • Beschreibung: Fügen Sie in einem einzigen Vorgang mehrere Kontakte zu einer Liste hinzu
     • Parameter:
       • listName (Zeichenfolge): Name der Liste
       • values (Array): Array von Kontaktobjekten
   • Kontakt aus der Liste entfernen
     • Name: removeContactFromList
     • Beschreibung: Entfernen Sie einen Kontakt aus einer bestimmten Liste
     • Parameter:
       • email (Zeichenfolge): E-Mail des Kontakts
       • listName (Zeichenfolge): Name der Liste
6. Kontaktstatusverwaltung
   • Abmelden Kontakt
     • Name: unsubscribeContact
     • Beschreibung: Einen Kontakt abbestellen oder unterdrücken
     • Parameter:
       • email (Zeichenfolge): E-Mail des Kontakts
   • Erneut abonnieren Kontakt
     • Name: resubscribeContact
     • Beschreibung: Einen zuvor abgemeldeten Kontakt erneut anmelden
     • Parameter:
       • email (Zeichenfolge): E-Mail des Kontakts
   • Archiv Kontakt
     • Name: archiveContact
     • Beschreibung: Einen Kontakt dauerhaft archivieren
     • Parameter:
       • email (Zeichenfolge): E-Mail des Kontakts
7. Kampagnenmanagement
   • E-Mail-Kampagne senden
     • Name: sendEmailToCampaign
     • Beschreibung: Eine E-Mail-Kampagne mit Personalisierung auslösen
     • Parameter:
       • campaignId (Zeichenfolge): Kampagnen-ID
       • email (Zeichenfolge): E-Mail des Empfängers
       • Verschiedene optionale Parameter zur individuellen Anpassung
   • Broadcast-Kampagne
     • Name: broadcastCampaignToList
     • Beschreibung: Kampagnen für eine ganze Kontaktliste auslösen
     • Parameter:
       • campaignId (Zeichenfolge): Kampagnen-ID
       • listId (Zeichenfolge): Ziellisten-ID
       • Optionale Parameter zur Kampagnenanpassung

Lizenz

MIT-Lizenz