mailprotector-mcp

MCP 서버 for Mailprotector — MSP를 위한 이메일 보안 관리 (CloudFilter, Bracket, SafeSend, XtraMail): 고객, 도메인, 사용자, 격리, 허용/차단 규칙, 로그, 구성, 그리고 라우터를 통한 전체 롱테일 API.

분할 v2 SDK(@modelcontextprotocol/server / /node / /client ^2.0.0-beta.5)를 통해 MCP 2026-07-28 스펙을 기반으로 구축되었으며 듀얼 에라 서빙을 제공합니다: createMcpHandler({ legacy: 'stateless' }) 뒤에 있는 하나의 공유 McpServerFactory가 2025 에라 initialize 핸드셰이크 클라이언트(현재 WYRE 게이트웨이)와 최신 2026-07-28 봉투 클라이언트 모두에 응답합니다 — 모든 호출자에게 동일하고 결정론적인 22개 도구 표면을 제공합니다. GHCR 컨테이너로만 제공됩니다(MCPB 번들 없음).

도구 (22개의 일급 도구 + 라우팅된 롱테일)

라우터: mailprotector_status, mailprotector_list_categories, mailprotector_list_category_tools, mailprotector_execute_tool.

승격된 읽기: mailprotector_customers_list/get, mailprotector_domains_list/get, mailprotector_users_list/get/find_by_address, mailprotector_user_groups_list, mailprotector_messages_list, mailprotector_allow_block_rules_list, mailprotector_logs_list, mailprotector_configuration_get.

승격된 쓰기: mailprotector_customers_create, mailprotector_domains_create, mailprotector_messages_release / release_many (⚠ HIGH-IMPACT), mailprotector_allow_block_rules_create (⚠ HIGH-IMPACT), 그리고 ⚠ 파괴적 — 되돌릴 수 없는 mailprotector_allow_block_rules_delete.

라우터 카테고리 (mailprotector_execute_tool을 통한 52개의 라우팅된 작업): resellers (CRUD), customers (update/delete), domains (update/delete/move/aliases), user_groups (CRUD + services), users (create/create_many/update/delete/reset_password/aliases), managers (CRUD + notification destinations), configuration (update), statements, email_routing (destinations/sources for domain|user_group), user_syncs (CRUD + schedule + filters), notifications (user notification destinations), results (find_by_code). 모든 라우팅된 삭제는 ⚠ 파괴적이며 확인 게이트가 있습니다; mailprotector_list_category_tools로 스키마를 확인하세요.

범위 지정 도구

Mailprotector의 계층 구조는 Provider → Reseller → Customer → Domain → User Group → User이며, 많은 작업이 여러 범위에 존재합니다. 범위 지정 도구는 scope(reseller | customer | domain | user_group | user, 도구별 하위 집합)와 scope_id를 받습니다; scope_id는 scope가 "reseller"일 때 바운드 리셀러로 기본 설정됩니다.

삭제 확인 (MRTR 유도)

모든 삭제는 SDK v2 MRTR seam을 통해 흐릅니다: 핸들러가 input_required를 반환하면, 대화형 클라이언트는 확인 프롬프트를 보게 되며, 거절하면 삭제가 취소됩니다. 유도 기능을 선언하지 않은 호출자(WYRE Conduit 게이트웨이와 같은 상태 비저장 2025 에라 호출자 포함)는 통합 계약에 따라 진행으로 대체됩니다: 여기서 유도는 순전히 추가적이며, 게이트웨이는 자체 서버 측 도구별 분류 게이트를 통해 파괴적 도구 접근을 강제합니다.

Related MCP server: avanan-mcp

자격 증명

게이트웨이 모드에서 헤더 중 하나가 누락되거나(또는 숫자가 아닌 리셀러 ID) 요청이 MCP 핸들러가 실행되기 전에 401(JSON-RPC 오류 -32001)로 응답됩니다 — 환경 변수 자격 증명으로 대체되지 않습니다.

실행

export NODE_AUTH_TOKEN=$(gh auth token)   # GitHub Packages auth for @wyre-technology/*
npm install
npm run build
node dist/index.js                        # stdio (default)
MCP_TRANSPORT=http node dist/index.js     # HTTP on :8080 (/mcp, /health)
node scripts/smoke-dual-era.mjs           # proves both protocol eras serve the same tools

Docker (linux/amd64, 함대 규정에 따라):

docker build --platform linux/amd64 --build-arg NODE_AUTH_TOKEN=$(gh auth token) -t mailprotector-mcp .
docker run -p 8080:8080 -e AUTH_MODE=env \
  -e MAILPROTECTOR_API_KEY=... -e MAILPROTECTOR_RESELLER_ID=... mailprotector-mcp

와이어 노트 (예상 듀얼 에라 동작)

• 레거시 에라 POST 응답은 SSE 프레임(text/event-stream)입니다 — 마지막 data: 줄을 파싱하세요.

• 레거시 GET/DELETE 세션 작업은 405로 응답합니다: 상태 비저장 서빙에는 세션이 없습니다.

라이선스

Apache-2.0