MailBridge MCP

Security-first, schreibgeschützte E-Mail-Intelligenz für MCP-kompatible KI-Assistenten.

MailBridge demonstriert, wie ein KI-Assistent mehrere Postfächer durchsuchen, Threads rekonstruieren, Anhänge prüfen und den Postfachzustand bewahren kann. Die öffentliche Verteilung läuft vollständig auf synthetischen Daten und ist daher ohne Anmeldedaten oder Zugriff auf einen echten Posteingang sicher zu erkunden.

Dieses Repository ist eine kontrollierte öffentliche Referenzverteilung von Gexiro Global Enterprises Ltd. Es ist kein Spiegel einer privaten Bereitstellung und enthält keine Produktionskonfiguration, Infrastruktur, Postfachdaten oder Anmeldedaten.

Warum MailBridge

• Elf bewusst schreibgeschützte MCP-Tools.

• Standardmäßige search- und fetch-Verträge für die Kompatibilität mit Wissensquellen.

• Explizite Ausgabeschemata für jedes strukturierte Tool-Ergebnis.

• MCP-Apps-Widget mit einer versionierten ui://-Ressource.

• Standards-orientierter ui/initialize- und ui/notifications/initialized-Handshake.

• Multi-Mailbox- und Alle-Ordner-Suchverhalten.

• Thread-Rekonstruktion mithilfe von Message-ID, In-Reply-To und References.

• Begrenzter Anhangsabruf mit SHA-256-Prüfsummen.

• Explizite Warnung, dass E-Mail- und Anhangs-Inhalte nicht vertrauenswürdig sind.

• Fail-closed-öffentliche Bindung: nur Loopback, sofern ein Betreiber explizit zustimmt.

• Keinerlei SMTP-, Sende-, Verschiebe-, Lösch-, Flag-, Anhänge-, Kopier- oder Expunge-Operationen.

Related MCP server: imap-2-mcp

Tool-Übersicht

Jeder Deskriptor setzt readOnlyHint: true, destructiveHint: false, idempotentHint: true und openWorldHint: false.

Schnellstart

Voraussetzungen: Node.js 24 oder neuer.

npm ci
npm run check
npm run dev

Der Server startet standardmäßig auf Loopback:

Health: http://127.0.0.1:3100/health
Widget: http://127.0.0.1:3100/widget
MCP:    http://127.0.0.1:3100/mcp

Um sich von einem MCP-Client zu verbinden, verwenden Sie den streamfähigen HTTP-Endpunkt /mcp. Für ChatGPT-Entwicklertests stellen Sie den Loopback-Dienst über einen geprüften HTTPS-Tunnel bereit und aktualisieren Sie die App nach Tool- oder Ressourcen-Metadatenänderungen.

Docker

Der Container bleibt rein synthetisch und läuft als unprivilegierter node-Benutzer.

docker build -t mailbridge-mcp .
docker run --rm -p 127.0.0.1:3100:3100 \
  -e MAILBRIDGE_HOST=0.0.0.0 \
  -e MAILBRIDGE_ALLOW_PUBLIC_DEMO=I_UNDERSTAND_SYNTHETIC_ONLY \
  mailbridge-mcp

Architektur

flowchart LR
    Host[ChatGPT or MCP host] -->|Streamable HTTP| MCP[MailBridge MCP server]
    MCP --> Tools[Read-only tool contracts]
    MCP --> Widget[MCP Apps dashboard]
    Tools --> Demo[Synthetic mailbox provider]
    Demo --> Guard[Untrusted-content and size guards]

Die Provider-Grenze ist bewusst klein gehalten. Diese öffentliche Ausgabe enthält nur den synthetischen Provider; Produktionsadapter, Operator-Identitäten, Anmeldedatenspeicherung und Bereitstellungstopologie liegen außerhalb dieses Repositorys.

Sicherheitseigenschaften

• In keinem MCP-Tool-Schema existiert eine Anmeldedateneingabe.

• In dieser öffentlichen Verteilung ist keine echte Postfachverbindung implementiert.

• Nachrichtenabrufe verändern den synthetischen Ungelesen-Status nicht.

• Anhangs-Bytes sind begrenzt und als nicht vertrauenswürdig gekennzeichnet.

• Die HTTP-Laufzeit verweigert die Nicht-Loopback-Bindung, sofern nicht die explizite synthetische Demo-Bestätigung gesetzt ist.

• CI führt Kompilierung, Tests, Repository-Secret-Scanning, Abhängigkeitsprüfung, Abhängigkeits-Review, CodeQL, einen echten Container-Smoke-Test und SBOM-Validierung durch.

• Das Container-Gate schlägt bei erkannten hohen oder kritischen CVEs fehl und entfernt Paketmanager aus dem Laufzeitbild nach der Abhängigkeitsinstallation.

• Getaggte Releases enthalten SHA-256-Prüfsummen, ein CycloneDX-SBOM und GitHub-Artefakt-Provenienz-Bestätigungen.

Siehe SECURITY.md, THREAT_MODEL.md, PRIVACY.md und ARCHITECTURE.md.

OpenAI-Apps-SDK-Ausrichtung

Die Implementierung folgt der aktuellen MCP-Apps-First-Anleitung:

• die UI-Ressource verwendet text/html;profile=mcp-app;

• Tools bleiben ohne das Widget nützlich;

• list_mailboxes verweist auf eine versionierte _meta.ui.resourceUri;

• das Widget konsumiert ui/notifications/tool-result und verwendet window.openai.toolOutput nur als Kompatibilitätspfad;

• CSP-Metadaten deklarieren keine externen Connect- oder Ressourcen-Domänen.

Offizielle Referenzen:

• Build an MCP server

• Add UI to your MCP server

• Define tools

• Plugin reference

Release-Integrität

Jedes getaggte Release wird aus gesperrten Abhängigkeiten in GitHub Actions erstellt. Verifizieren Sie das heruntergeladene Archiv und das SBOM mit den enthaltenen SHA256SUMS und verifizieren Sie dann die GitHub-Artefakt-Bestätigung gegen dieses Repository, bevor Sie es verwenden.

Projektrichtlinien

• Changelog

• Contributing

• Code of Conduct

• Support

• Security

• Privacy

Lizenz

Apache License 2.0. Urheberrecht © 2026 Gexiro Global Enterprises Ltd.