proton-mcp

Proton Mail 用のセルフホスト型 Model Context Protocol (MCP) サーバー。Proton Mail Bridge の隣で実行するように設計され、MCP クライアントに対して小さく、監査可能なメールボックスツール一式を公開します。

ステータス: 初期開発中。v0.1 は意図的に読み取り専用です。

目標

• NAS またはホームサーバー上で Docker Compose を使って継続的に実行する。

• Proton Mail Bridge を LAN およびインターネットから隔離した状態に保つ。

• Proton の暗号化を直接扱わず、ローカルの IMAP/SMTP 経由で Bridge と通信する。

• 汎用的なシェルやファイルシステムへのアクセスではなく、限定された MCP ツールを公開する。

• メールボックスの整理を効率化するために、まずメタデータを返し、完全なメッセージ本文は必要に応じてのみ返す。

• 読み取り専用インターフェースが十分にテストされた後でのみ、制御された書き込み操作を追加する。

Related MCP server: proton-mail-mcp

v0.1 で計画されているツール

• list_folders

• mailbox_stats

• top_senders

• search_mail

• get_message

ツール契約については docs/SPEC.md、デプロイモデルについては ARCHITECTURE.md を参照してください。

デプロイモデル

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

意図された Docker Compose デプロイでは、proton-mcp と proton-bridge が共有ネットワーク名前空間を持つため、Bridge をループバックにバインドしたままにできる。IMAP/SMTP ポートを LAN に公開してはならない。

開発原則

• リポジトリ、イメージ、ログ、通常の環境変数に Proton アカウントのパスワードを置かないこと。

• 任意のシェル MCP ツールを置かないこと。

• v0.1 に破壊的な MCP ツールを置かないこと。

• 大量のメール本文を LLM に送るのではなく、決定的なメールボックス処理を優先すること。

• 検証 簡単さを保つこと。将来のエージェントは、作業を終える前に 1 つのコマンド（make check）を実行できるようにすること。

ドキュメント

• AGENTS.md — コーディングエージェントのための簡潔な指示。

• ARCHITECTURE.md — システムの境界と設計判断。

• SECURITY.md — セキュリティの不変条件。

• docs/SPEC.md — MCP ツール契約。

• docs/DEVELOPMENT.md — ローカル開発ワークフロー。

• docs/OPERATIONS.md — Synology / Docker の運用。

ライセンス

MIT。 LICENSE を参照してください。