proton-mcp

Ein selbstgehosteter Model Context Protocol (MCP)-Server für Proton Mail, der entwickelt wurde, um neben der Proton Mail Bridge zu laufen und eine kleine, überprüfbare Auswahl an Postfach-Tools für MCP-Clients bereitzustellen.

Status: frühe Entwicklung. v0.1 ist bewusst schreibgeschützt.

Ziele

• Dauerhaft auf einem NAS oder Heimserver mit Docker Compose laufen.

• Proton Mail Bridge von LAN und Internet isoliert halten.

• Über lokales IMAP/SMTP mit der Bridge kommunizieren, statt die Proton-Verschlüsselung direkt zu übernehmen.

• Schlanke MCP-Tools bereitstellen statt generischem Shell- oder Dateisystemzugriff.

• Die Postfach-Bereinigung effizient machen, indem zuerst Metadaten und vollständige Nachrichten enthalten sind.

• Kontrollierte Schreibaktionen erst hinzufügen, wenn die schreibgeschützte Schnittstelle gut getestet ist.

Related MCP server: proton-mail-mcp

Für v0.1 geplante Tools

• list_folders

• mailbox_stats

• top_senders

• search_mail

• get_message

Siehe docs/SPEC.md für den Tool-Vertrag und ARCHITECTURE.md für das Bereitstellungsmodell En.

Deploymentmodell

MCP client
    |
    | authenticated MCP
    v
proton-mcp container
    |
    | localhost IMAP
    v
proton-bridge container
    |
    v
Proton Mail

Die vorgesehene Docker-Compose-Bereitstellung gibt proton-mcp und proton-bridge einen gemeinsamen Netzwerk-Namespace, sodass die Bridge weiterhin an den Loopback gebunden bleiben kann. IMAP/SMTP-Ports dürfen nicht im LAN verfügbar gemacht oder veröffentlicht werden.

Entwicklungsprinzipien

• Kein Proton-Konto-Passwort im Repository, im Image, in Protokollen oder normalen Umgebungsvariablen.

• Kein beliebiges Shell-MCP-Tool.

• Keine destruktiven MCP-Tools in v0.1.

• Deterministische Postfach-Verarbeitung bevorzugen, anstatt große Mengen von E-Mail-Inhalten an ein LLM zu senden.

• Halte die Validierung einfach: Zukünftige Agenten sollen in der Lage sein, vor Abschluss der Arbeit einen einzigen Befehl (make check) auszuführen.

Dokumentation

• AGENTS.md — knappe Anweisungen für Coding-Agenten.

• ARCHITECTURE.md — Systemgrenzen und Entscheidungen.

• SECURITY.md — Sicherheitsinvarianten.

• docs/SPEC.md — MCP-Tool-Vertrag.

• docs/DEVELOPMENT.md — lokaler Entwicklungs-Workflow.

• docs/OPERATIONS.md — Synology-/Docker-Betrieb.

Lizenz

MIT. Siehe LICENSE.