proton-mcp

Сервер Model Context Protocol (MCP) для Proton Mail, предназначенный для самостоятельного развёртывания и работы рядом с Proton Mail Bridge; он предоставляет MCP-клиентам небольшой, поддающийся аудиту набор инструментов для работы с почтовым ящиком.

Статус: ранняя разработка. v0.1 намеренно доступен только для чтения.

Цели

• Постоянно работать на NAS или домашнем сервере через Docker Compose.

• Держать Proton Mail Bridge изолированным от локальной сети и интернета.

• Общаться с Bridge через локальные протоколы IMAP/SMTP, а не обрабатывать шифрование Proton напрямую.

• Предоставлять узкие 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 оставался привязанным к loopback. Порты IMAP/SMTP не должны публиковаться в локальную сеть.

Принципы разработки

• Никакого пароля учётной записи Proton в репозитории, образе, журналах или обычных переменных окружения.

• Никакого произвольного MCP-инструмента для оболочки.

• Никаких разрушительных MCP-инструментов в v0.1.

• Предпочитать детерминированную обработку почтового ящика отправке больших объёмов содержимого писем в LLM.

• Сохранять проверку простой: будущие агенты должны иметь возможность выполнить одну команду (make check) перед завершением работы.

Документация

• AGENTS.md — краткие инструкции для агентов разработки.

• ARCHITECTURE.md — границы системы и принятые решения.

• SECURITY.md — инварианты безопасности.

• docs/SPEC.md — контракт MCP-инструментов.

• docs/DEVELOPMENT.md — процесс локальной разработки.

• docs/OPERATIONS.md — эксплуатация Synology / Docker.

Лицензия

MIT. Смотрите LICENSE.