TKasperczyk/thunderbird-mcp

Thunderbird MCP – Thunderbird를 위한 AI 친화적 브리지

개요 – Thunderbird 애드온과 Node.js 브리지를 결합하여 Model-Context-Protocol(MCP) 호환 AI 어시스턴트(Claude, GPT, 로컬 LLM 등)가 Thunderbird 내에서 메일, 연락처, 필터, 캘린더를 직접 읽고, 작성하고, 정리하고, 검색할 수 있게 합니다.

중요성 – Thunderbird에는 공식 API가 없습니다. 이 브리지가 없으면 AI는 받은 편지함을 볼 수 없고 답장 초안 작성도 도울 수 없습니다. 이 확장 프로그램은 MCP를 통해 약 40개의 도구(계정 목록, 메시지 검색, 전체 메시지 본문 가져오기, 메일 보내기, 필터 관리, 연락처, 캘린더 이벤트 등)를 안전하게 노출하여 AI 에이전트가 사람처럼 메일함을 조작할 수 있게 합니다.

작동 방식

• 애드온에는 localhost:8765‑8774에서 수신 대기하는 HTTP 서버가 포함되어 있으며 세션별 인증 토큰을 사용합니다.
• Node.js 스크립트(mcp-bridge.cjs)가 표준 MCP stdio 프로토콜을 로컬 HTTP API로 변환하고, 연결 파일을 통해 포트/토큰을 발견하며, MCP 수명 주기 호출(initialize, ping)을 처리하여 Thunderbird 로딩이 완료되기 전에도 AI가 연결할 수 있게 합니다.
• 모든 통신은 로컬 머신 내에서 이루어지며 외부 네트워크 트래픽이 필요하지 않습니다.

주요 기능

영역	도구(선택)	할 수 있는 일
메일	listAccounts, listFolders, searchMessages, getMessage(s), displayMessage, updateMessage, deleteMessages, createFolder …	계정 탐색, 헤더/본문 검색, 마크다운/텍스트/HTML로 메시지 읽기, UI에서 열기, 읽음/안읽음 표시, 태그 추가, 이동/복사, 폴더 생성/삭제, 휴지통/스팸 비우기.
작성	sendMail, saveDraft, replyToMessage, forwardMessage	검토 창 열기 또는(skipReview 안전 플래그를 비활성화한 후) 직접 보내기, 초안 저장, 스레드 유지 답장, 첨부 파일 포함 전달.
필터	listFilters, createFilter, updateFilter, deleteFilter, reorderFilters, applyFilters	메일 필터 나열, 생성, 편집, 재정렬, 수동 실행; 명시적으로 활성화하지 않는 한 자동 전달/답장 작업은 차단됩니다.
연락처	searchContacts, getContact, createContact, updateContact, deleteContact	주소록 항목 검색, 읽기, 생성, 수정, 삭제.
캘린더	listCalendars, createEvent, listEvents, updateEvent, deleteEvent	캘린더 나열, 이벤트 생성(기본적으로 검토 창), 반복 확장 포함 이벤트 쿼리, 편집 또는 삭제.

안전 및 개인정보 보호

• 로컬 전용 – 서버는 localhost에 바인딩되고 세션별 토큰을 사용합니다. 데이터가 컴퓨터를 벗어나지 않습니다.
• 기본 검토 – skipReview를 끄지 않는 한 메일 보내기, 참석자가 있는 이벤트 생성, 자동 필터 작업이 차단됩니다.
• 암호화 메일 – 옵트인하지 않으면 암호화된 메시지에 대한 접근이 비활성화됩니다.
• MIME 및 크기 제한 – 인라인 이미지는 MCP 이미지 블록으로만 포함됩니다(각 최대 1 MiB, 총 4 MiB). 2 MiB를 초과하는 HTML 본문은 명확한 알림과 함께 잘립니다.
• 엄격한 검증 – 태그 키, 필터 문자열, 연락처 필드, 캘린더 참석자는 Thunderbird 자체 규칙을 기준으로 검증되며, 잘못된 입력은 조용히 수정되지 않고 전체 호출이 실패합니다.

일반적인 워크플로

1. Thunderbird에 애드온을 설치합니다.
2. 브리지를 시작(node mcp-bridge.cjs)하거나 데스크톱 클라이언트가 실행하게 합니다.
3. AI 모델(예: Claude)이 MCP를 통해 연결하고 인증 토큰과 포트를 받습니다.
4. 모델은 searchMessages와 같은 도구를 호출하여 관련 메일을 찾고, getMessage로 읽고, sendMail(skipReview 비활성화 후)로 답장을 작성합니다.
5. 모든 작업은 Thunderbird 내에서 수행되며 기존 계정, 서명, 폴더 구조가 유지됩니다.

사용 대상 – 메일함에 대한 깊은 접근이 필요한 AI 어시스턴트를 개발하는 개발자, LLM이 이메일 분류를 돕기를 원하는 파워 유저, 개인 정보 보호 중심의 로컬 호스팅 스택에서 'AI 개인 비서'를 실험하려는 모든 사람.

---

결론 – Thunderbird MCP는 AI 모델에 Thunderbird의 메일, 연락처, 필터, 캘린더에 대한 구체적이고 문서화된 제어를 제공하면서 모든 것을 온디바이스로 유지하고 합리적인 안전 기본값으로 보호하는 진정한 오픈 소스 브리지입니다.