proton-mcp

Proton Mail용 자체 호스팅 Model Context Protocol(MCP) 서버로, Proton Mail Bridge 옆에서 실행되도록 설계되었으며 MCP 클라이언트에 작고 감사 가능한 사서함 도구 집합을 노출합니다.

상태: 초기 개발 단계. v0.1은 의도적으로 읽기 전용입니다.

목표

• Docker Compose를 이용해 NAS 또는 홈 서버에서 지속적으로 실행합니다.

• 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 Mail 비밀번호를 포함하지 않습니다.

• 임의의 셸 MCP 도구를 제공하지 않습니다.

• v0.1에는 파괴적인 MCP 도구가 없습니다.

• 대량의 이메일 콘텐츠를 LLM에 보내는 것보다 결정적인 사서함 처리를 선호합니다.

• 검증을 단순하게 유지합니다. 향후 에이전트는 작업을 마치기 전에 하나의 명령(make check)만 실행할 수 있어야 합니다.

문서

• AGENTS.md — 코딩 에이전트를 위한 간결한 지침

• ARCHITECTURE.md — 시스템 경계와 결정 사항

• SECURITY.md — 보안 불변식

• docs/SPEC.md — MCP 도구 계약

• docs/DEVELOPMENT.md — 로컬 개발 워크플로우

• docs/OPERATIONS.md — Synology / Docker 운영

라이선스

MIT. LICENSE를 참조하세요.