mailprotector-mcp

Mailprotector 用のMCPサーバー — MSP向けメールセキュリティ管理 (CloudFilter, Bracket, SafeSend, XtraMail): 顧客、ドメイン、ユーザー、隔離、 許可/ブロックルール、ログ、設定、そしてルーターを介した完全なロングテールAPI。

MCP 2026-07-28 仕様に基づき、分割v2 SDK (@modelcontextprotocol/server / /node / /client ^2.0.0-beta.5) を使用し、デュアルエラ時代の 提供を実現: 1つの共有 McpServerFactory を createMcpHandler({ legacy: 'stateless' }) の背後で使用し、 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 (⚠ 高影響), mailprotector_allow_block_rules_create (⚠ 高影響)、および ⚠ 破壊的 — 元に戻せない mailprotector_allow_block_rules_delete.

ルーターカテゴリー (mailprotector_execute_tool を介した52のルーティング操作): resellers (CRUD), customers (更新/削除), domains (更新/削除/移動/エイリアス), user_groups (CRUD + サービス), users (作成/create_many/更新/削除/パスワードリセット/エイリアス), managers (CRUD + 通知先), configuration (更新), statements, email_routing (ドメイン|user_groupの送信先/送信元), user_syncs (CRUD + スケジュール + フィルター), notifications (ユーザー通知先), results (find_by_code). ルーティングされたすべての削除は⚠ 破壊的であり、 確認ゲート付き; スキーマは mailprotector_list_category_tools で発見可能。

スコープ付きツール

Mailprotectorの階層は プロバイダー → リセラー → 顧客 → ドメイン → ユーザーグループ → ユーザー であり、 多くの操作が複数のスコープで存在します。スコープ付きツールは scope (reseller | customer | domain | user_group | user、ツールごとにサブセット) と scope_id を受け取ります; scope_id のデフォルトは バインドされたリセラー (scopeが "reseller" の場合)。

削除確認 (MRTR エリシテーション)

すべての削除はSDK v2 MRTRの継ぎ目を通過: ハンドラーは 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