mailprotector-mcp

MCP сервер для Mailprotector — управление безопасностью электронной почты для MSP (CloudFilter, Bracket, SafeSend, XtraMail): клиенты, домены, пользователи, карантин, правила разрешения/блокировки, журналы, конфигурация и полный длинный хвост API через маршрутизатор.

Построен на спецификации MCP 2026-07-28 через разделенный SDK v2 (@modelcontextprotocol/server / /node / /client ^2.0.0-beta.5) с двухэпохальным обслуживанием: один общий 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.

Категории маршрутизатора (52 маршрутизированных операции через mailprotector_execute_tool): resellers (CRUD), customers (обновление/удаление), domains (обновление/удаление/перемещение/псевдонимы), user_groups (CRUD + услуги), users (создание/создание_многих/обновление/удаление/сброс_пароля/псевдонимы), managers (CRUD + уведомительные адресаты), configuration (обновление), statements, email_routing (назначения/источники для domain|user_group), user_syncs (CRUD + расписание + фильтры), notifications (уведомительные адресаты пользователей), results (найти_по_коду). Каждое маршрутизированное удаление является ⚠ РАЗРУШИТЕЛЬНЫМ и требует подтверждения; схемы открываются через mailprotector_list_category_tools.

Инструменты с областью действия

Иерархия Mailprotector: Провайдер → Реселлер → Клиент → Домен → Группа пользователей → Пользователь, и многие операции доступны на нескольких уровнях. Инструменты с областью действия принимают scope (reseller | customer | domain | user_group | user, подмножества для каждого инструмента) плюс scope_id; scope_id по умолчанию равен привязанному реселлеру, когда scope равно "reseller".

Подтверждения удаления (вызов MRTR)

Каждое удаление проходит через разрыв SDK v2 MRTR: обработчик возвращает input_required, интерактивные клиенты видят запрос подтверждения, а отказ отменяет удаление. Вызывающие, которые не объявили возможности вызова — включая статлесс-клиентов 2025 года, таких как шлюз WYRE Conduit, — по умолчанию продолжают в соответствии с контрактом интеграции: вызов здесь является чисто аддитивным, и шлюз обеспечивает доступ к разрушительным инструментам с помощью собственного серверного шлюза классификации по инструментам.

Related MCP server: avanan-mcp

Учётные данные

В режиме шлюза запрос, в котором отсутствует любой из заголовков (или указан нечисловой идентификатор реселлера), получает ответ 401 (ошибка JSON-RPC -32001) до выполнения обработчика MCP — он никогда не попадает в учётные данные окружения.

Запуск

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 legacy-эпохи оформлены в формате SSE (text/event-stream) — анализируйте последнюю строку data:.

• Операции GET/DELETE сессии legacy-эпохи отвечают 405: статлесс-обслуживание не имеет сессий.

Лицензия

Apache-2.0