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），支持双时代 服务：一个共享的 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 （创建/批量创建/更新/删除/重置密码/别名）、managers（CRUD + 通知目标）、configuration（更新）、statements、 email_routing（域名|用户组的目标/来源）、user_syncs （CRUD + 计划 + 过滤器）、notifications（用户通知目标）、 results（按代码查找）。每个路由的删除操作都是 ⚠ 破坏性的，并且 需要确认；使用 mailprotector_list_category_tools 发现模式。

作用域工具

Mailprotector 的层级结构是 提供商 → 经销商 → 客户 → 域名 → 用户组 → 用户， 许多操作存在于多个作用域。作用域工具接受 scope （reseller | customer | domain | user_group | user，按工具子集）加上 scope_id； 当 scope 为 "reseller" 时，scope_id 默认为绑定的经销商。

删除确认（MRTR 引导）

每个删除操作都通过 SDK v2 MRTR 接口进行：处理程序返回 input_required，交互式客户端会看到确认提示，拒绝 则取消删除。声明无引导能力的调用者 — 包括 无状态的 2025 时代调用者，例如 WYRE Conduit 网关 — 回退到 继续执行，根据集成合同：此处的引导纯粹是附加的， 网关使用其自己的服务器端 按工具分类门强制执行破坏性工具访问。

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