MailBridge MCP

MCP 호환 AI 어시스턴트를 위한 보안 우선의 읽기 전용 이메일 인텔리전스.

MailBridge는 AI 어시스턴트가 여러 사서함을 검색하고, 스레드를 재구성하고, 첨부 파일을 검사하고, 사서함 상태를 보존하는 방법을 보여줍니다. 공개 배포판은 전적으로 합성 데이터로 실행되므로 자격 증명이나 실제 받은 편지함 접근 없이 안전하게 탐색할 수 있습니다.

이 저장소는 Gexiro Global Enterprises Ltd.가 제공하는 통제된 공개 참조 배포판입니다. 비공개 배포판의 미러가 아니며, 프로덕션 구성, 인프라, 사서함 데이터 또는 자격 증명을 포함하지 않습니다.

MailBridge를 선택하는 이유

• 일부러 읽기 전용으로 설계된 11개의 MCP 도구.

• 지식 소스 호환성을 위한 표준 search 및 fetch 계약.

• 모든 구조화된 도구 결과에 대한 명시적 출력 스키마.

• 버전이 지정된 ui:// 리소스를 사용하는 MCP Apps 위젯.

• 표준 우선 ui/initialize 및 ui/notifications/initialized 핸드셰이크.

• 다중 사서함 및 전체 폴더 검색 동작.

• Message-ID, In-Reply-To, References를 사용한 스레드 재구성.

• SHA-256 체크섬을 사용한 제한된 첨부 파일 검색.

• 이메일 및 첨부 파일 콘텐츠를 신뢰할 수 없음을 명시적으로 경고.

• 기본 차단 방식의 공개 바인딩: 운영자가 명시적으로 동의하지 않으면 루프백 전용.

• SMTP, 보내기, 이동, 삭제, 플래그, 추가, 복사 또는 영구 삭제(expunge) 작업이 전혀 없음.

Related MCP server: Outlook MCP Server

도구 목록

모든 설명자는 readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false를 설정합니다.

빠른 시작

요구 사항: Node.js 24 이상.

npm ci
npm run check
npm run dev

서버는 기본적으로 루프백에서 시작됩니다:

Health: http://127.0.0.1:3100/health
Widget: http://127.0.0.1:3100/widget
MCP:    http://127.0.0.1:3100/mcp

MCP 클라이언트에서 연결하려면 스트리밍 가능한 HTTP 엔드포인트 /mcp를 사용하세요. ChatGPT 개발자 테스트의 경우, 검토된 HTTPS 터널을 통해 루프백 서비스를 노출하고 도구 또는 리소스 메타데이터가 변경된 후 앱을 새로고침하세요.

Docker

컨테이너는 합성 전용으로 유지되며 비특권 node 사용자로 실행됩니다.

docker build -t mailbridge-mcp .
docker run --rm -p 127.0.0.1:3100:3100 \
  -e MAILBRIDGE_HOST=0.0.0.0 \
  -e MAILBRIDGE_ALLOW_PUBLIC_DEMO=I_UNDERSTAND_SYNTHETIC_ONLY \
  mailbridge-mcp

아키텍처

flowchart LR
    Host[ChatGPT or MCP host] -->|Streamable HTTP| MCP[MailBridge MCP server]
    MCP --> Tools[Read-only tool contracts]
    MCP --> Widget[MCP Apps dashboard]
    Tools --> Demo[Synthetic mailbox provider]
    Demo --> Guard[Untrusted-content and size guards]

프로바이더 경계는 의도적으로 작게 유지됩니다. 이 공개 버전은 합성 프로바이더만 포함합니다. 프로덕션 어댑터, 운영자 ID, 자격 증명 저장소, 배포 토폴로지는 이 저장소에 포함되지 않습니다.

보안 속성

• 어떤 MCP 도구 스키마에도 자격 증명 입력이 없습니다.

• 이 공개 배포판에는 실제 사서함 연결이 구현되어 있지 않습니다.

• 메시지 가져오기는 합성 읽지 않음 상태를 변경하지 않습니다.

• 첨부 파일 바이트는 크기가 제한되고 신뢰할 수 없음으로 표시됩니다.

• HTTP 런타임은 명시적인 합성 데모 승인 플래그가 설정되지 않는 한 비루프백 바인딩을 거부합니다.

• CI는 컴파일, 테스트, 저장소 비밀 검사, 종속성 감사, 종속성 검토, CodeQL, 실제 컨테이너 스모크 테스트, SBOM 검증을 실행합니다.

• 컨테이너 게이트는 High 또는 Critical CVE가 감지되면 폐쇄적으로 실패하며, 종속성 설치 후 런타임 이미지에서 패키지 관리자를 제거합니다.

• 태그된 릴리스에는 SHA-256 체크섬, CycloneDX SBOM, GitHub 아티팩트 출처 증명이 포함됩니다.

다음을 참조하세요: SECURITY.md, THREAT_MODEL.md, PRIVACY.md, ARCHITECTURE.md.

OpenAI Apps SDK 정렬

이 구현은 현재 MCP Apps 우선 가이드를 따릅니다:

• UI 리소스는 text/html;profile=mcp-app을 사용합니다;

• 도구는 위젯 없이도 유용하게 동작합니다;

• list_mailboxes는 버전이 지정된 _meta.ui.resourceUri를 가리킵니다;

• 위젯은 ui/notifications/tool-result를 소비하고 window.openai.toolOutput은 호환성 경로로만 사용합니다;

• CSP 메타데이터는 외부 연결 또는 리소스 도메인을 선언하지 않습니다.

공식 참고 자료:

• MCP 서버 구축

• MCP 서버에 UI 추가

• 도구 정의

• 플러그인 참조

릴리스 무결성

각 태그된 릴리스는 GitHub Actions에서 잠긴(locked) 종속성으로 빌드됩니다. 다운로드한 아카이브와 SBOM을 포함된 SHA256SUMS로 검증한 후, 사용 전에 GitHub 아티팩트 증명을 이 저장소와 대조하여 검증하세요.

프로젝트 정책

• 변경 로그

• 기여

• 행동 강령

• 지원

• 보안

• 개인정보 처리방침

라이선스

Apache License 2.0. 저작권 © 2026 Gexiro Global Enterprises Ltd.