dmarc-examiner

@dmarc-examiner/mcp

DMARC Examiner 的官方 MCP（Model Context Protocol）服务，适用于 DMARC Examiner。通过 Claude Desktop、Claude Code 和 Cursor 等 AI 助手查询 DMARC 监控数据。

为什么需要它

DMARC 汇总报告以压缩 XML 格式接收，每个接收方每天一个文件。要查看这些报告，要么打开仪表板，要么手动解析 XML。

此服务通过 MCP 连接提供这些数据，让你可以直接提问：

上周哪些发送源未通过 DMARC 对齐检查？

显示 SPF 通过但 DKIM 未通过的域名。

将 example.com 的报告导出为 CSV。

DMARC Examiner 是一项提供免费套餐的 DMARC 监控服务——使用此服务需要拥有账户，但不需要付费套餐。

快速设置

选项 1：远程 URL（推荐）

大多数 MCP 客户端都直接支持远程 HTTP 服务。将以下内容添加到 MCP 配置中：

{
  "mcpServers": {
    "dmarc-examiner": {
      "url": "https://mcp.dmarc-examiner.com/mcp"
    }
  }
}

选项 2：npx（适用于不支持远程 HTTP 的客户端）

{
  "mcpServers": {
    "dmarc-examiner": {
      "command": "npx",
      "args": ["-y", "@dmarc-examiner/mcp"]
    }
  }
}

按客户端配置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "dmarc-examiner": {
      "url": "https://mcp.dmarc-examiner.com/mcp"
    }
  }
}

Claude Code

claude mcp add dmarc-examiner --transport http https://mcp.dmarc-examiner.com/mcp

Cursor

将以下内容添加到 Cursor 的 MCP 设置中：

{
  "mcpServers": {
    "dmarc-examiner": {
      "url": "https://mcp.dmarc-examiner.com/mcp"
    }
  }
}

授权

添加服务无需授权。 服务会立即启动，无需凭据即可响应 initialize、tools/list 和 ping，因此客户端可以马上列出全部 21 个工具。

首次调用会访问你数据的工具时，浏览器会打开。你需要：

1. 登录 DMARC Examiner 账户
2. 选择要连接的组织
3. 批准请求的权限（作用域）

随后，系统会自动重放你发起的调用，因此调用会顺利完成，而不会失败。

使用选项 1时，MCP 客户端会自行处理此流程。使用选项 2时，由此软件包处理：它会注册为 OAuth 客户端、打开浏览器，并将生成的令牌以 0600 权限存储在 ~/.dmarc-examiner/mcp-credentials.json 中。后续运行会复用刷新令牌，因此浏览器授权只需进行一次。

这样设计的原因。 启动时授权看似是理所当然的设计，但它会导致所有自动化客户端无法正常工作：目录检查、扫描器和 CI 都无法打开浏览器，因此服务看起来会卡住，检查也会超时。我们在你的远程 MCP 服务将无法通过任何目录检查中记录了这一问题及解决方案，并附有日志。

你也可以直接调用：

npx -y @dmarc-examiner/mcp login    # authorize now, outside your MCP client
npx -y @dmarc-examiner/mcp logout   # forget the stored credentials

将 DMARC_EXAMINER_MCP_URL 设置为其他端点，使软件包指向该端点。

可用工具

域名

工具	描述	作用域
list_domains	列出组织中所有受监控的域名	domains:read
get_domain	获取特定域名的详细信息	domains:read
check_dmarc	检查 _dmarc.<domain> 中公开的 DMARC 记录。适用于任何域名，不仅限于你自己的域名	domains:read
create_domain	添加域名。返回用于发布到 DNS 的报告邮箱和 DMARC 记录	domains:manage
verify_domain	重新检查 DNS，确认 DMARC 记录中包含你的报告地址	domains:manage
delete_domain	从监控中移除域名。软删除，历史报告仍会保留	domains:manage

汇总报告（RUA）

工具	描述	范围
list_reports	按筛选条件列出 DMARC 报告	reports:read
get_report	获取包含记录的详细报告	reports:read
get_report_statistics	按国家和 ASN 查看报告统计数据	reports:read
export_report_csv	将报告导出为 CSV	reports:export

取证报告（RUF）

需要 Pro 套餐或更高版本；否则会返回 403。

工具	描述	范围
list_forensic_reports	按筛选条件和分页列出 RUF 报告	forensic:read
get_forensic_report	获取取证报告的完整详情，包括失败邮件的信封信息	forensic:read
get_forensic_reports_statistics	按失败类型、投递结果、含地理位置的源 IP 和域名统计数量	forensic:read
get_forensic_reports_summary	查看过去 7 天的取证活动	forensic:read

警报

工具	描述	范围
list_alerts	列出安全警报	alerts:read
dismiss_alert	忽略警报	alerts:manage

Webhook

需要 Pro 套餐或更高版本；否则会返回 403。

工具	描述	范围
list_webhooks	列出已配置的 Webhook 端点	webhooks:read
create_webhook	创建端点。URL 必须使用 HTTPS	webhooks:manage
update_webhook	更新端点的 URL、名称或启用状态	webhooks:manage
delete_webhook	永久删除端点	webhooks:manage
test_webhook	发送 webhook.test 事件并返回投递状态	webhooks:manage

范围

范围	描述
domains:read	查看受监控的域名
domains:manage	添加、验证和移除域名
reports:read	查看报告和统计数据
reports:export	将报告导出为 CSV
forensic:read	查看取证（RUF）报告
alerts:read	查看警报
alerts:manage	管理警报（忽略）
webhooks:read	查看 Webhook 端点
webhooks:manage	创建、更新、删除和测试 Webhook

文档

如需详细文档，请访问：https://dmarc-examiner.com/docs/settings/mcp-integration?utm_source=github&utm_medium=content&utm_campaign=mcp-repo

支持

• 文档：https://dmarc-examiner.com/docs?utm_source=github&utm_medium=content&utm_campaign=mcp-repo
• 电子邮件：[email protected]

许可证

MIT — 参见 LICENSE。