Email Deliverability Checker

email-deliverability-mcp

一个 MCP 服务，可让 Claude（或任何 MCP 客户端）诊断电子邮件的送达能力：

• check_domain：检查 SPF（包括 10 次 DNS 查询的限制）、DMARC 策略和报告、常见选择器上的 DKIM 密钥以及 MX 记录，并按优先级列出问题及对应的修复方法。它还会指出域名使用的电子邮件服务（Google Workspace、SendGrid、Amazon SES 等）。
• check_sending_ip：检查反向 DNS（PTR）及其是否解析回该 IP，同时检查该 IP 是否列在 Spamhaus ZEN、Barracuda、SpamCop、PSBL、Mailspike 和 UCEPROTECT level 1 中。
• check_email_headers：粘贴收到的邮件头，检查它们是否符合 Gmail 和 Yahoo 的发件人要求：SPF、DKIM、DMARC、From 对齐、一键退订（以及 DKIM 是否涵盖该字段）、TLS、反向 DNS 和 Message-ID。

所有工具均为只读：它们只读取公共 DNS，或你提供的文本。不会向任何其他地方发送信息，也不需要账户或 API 密钥。

无需安装即可使用

可通过以下托管版本运行：

https://api.ownmailserver.com/tools/mcp

将其作为自定义连接器添加到 Claude（Settings → Connectors → Add custom connector），或在 Claude Code 中使用：

claude mcp add --transport http email-deliverability https://api.ownmailserver.com/tools/mcp

该服务免费且无需账户。它按 IP 限流，使用公共 DNS 解析器（因此 Spamhaus 结果会显示为 “refused”；见下文），并且不会存储任何内容。如需大量使用或获取真实的 Spamhaus 查询结果，请运行自己的副本。

安装

需要 Node.js 20 或更高版本。

Claude Code

claude mcp add email-deliverability -- npx -y email-deliverability-mcp

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "email-deliverability": {
      "command": "npx",
      "args": ["-y", "email-deliverability-mcp"]
    }
  }
}

Docker

docker build -t email-deliverability-mcp .
docker run -i --rm email-deliverability-mcp

可以询问的问题

• “检查 example.com 的电子邮件配置，并告诉我应该先修复什么。”
• “我们从 shop.example 发出的邮件为什么可能会进入垃圾邮件？”（然后粘贴邮件头）
• “192.0.2.25 是否在任何黑名单中？它的反向 DNS 是否正确？”
• “这封邮件是否符合 Gmail 的批量发件人规则？”
• “我们的 SPF 记录有时会验证失败。我们是否超过了查询次数限制？”

配置

变量	默认值	用途
BLOCKLIST_DNS	系统解析器	用于黑名单查询的递归解析器 IP，以逗号分隔。该解析器必须由你运行。
DNS_SERVERS	系统解析器	用于所有其他查询的解析器 IP，以逗号分隔。

BLOCKLIST_DNS 的重要性

Spamhaus 会拒绝通过大型公共解析器（8.8.8.8、1.1.1.1 等）发起的查询，并改为返回 127.255.255.x。许多黑名单检查工具会误将其解读为“已列入黑名单”。本服务会将其报告为 refused，表示结果未知，并明确说明这一点。如需获取真实的 Spamhaus 查询结果，请将 BLOCKLIST_DNS 指向你自己的递归解析器，例如运行在 127.0.0.1 上的 unbound。

检查的工作原理

• SPF 查询会递归跟进 include: 和 redirect=，并按 RFC 7208 的规定，统计每个 include、a、mx、ptr、exists 和 redirect 项。超过 10 项会导致大多数接收方判定为永久错误。
• DKIM 密钥位于只有发件人才知道的选择器下，因此本服务会探测约 30 个常见选择器。你也可以通过 dkim_selectors 传入自己的选择器（从邮件 DKIM-Signature 邮件头的 s= 值中查找）。本服务会检测对所有名称都返回响应的域名（通配符 DNS），不会将其报告为存在密钥。
• 邮件头检查会读取最上方的 Authentication-Results 邮件头，也就是收件方邮箱服务商得出的结论；同时读取最新一条标明发件服务器的 Received 跳点。
• 对齐检查使用简单规则比较组织域名（取末尾两个标签，或对 example.co.uk 这类名称取末尾三个标签）。它不是完整的公共后缀列表查询，因此可能会误判不常见的后缀。

开发

npm install
npm test          # unit tests with a fake DNS resolver
npm run build     # compiles to dist/
npm run start:http  # the HTTP version (PORT, MCP_PATH, TRUST_PROXY, RATE_LIMIT, GLOBAL_LIMIT)

关于

由 OwnMailServer 构建。OwnMailServer 为每月发送 250,000 至 1,000,000 封邮件的企业提供专用邮件发送服务：自有服务器和 IP、类似 Resend 的 API 和 SMTP、托管预热以及每日监控。OwnMailServer 账户还可使用 Claude 连接器，查看自己的发送数据：投递统计、退信、投诉和邮件历史记录。

同样的检查也可通过免费网页工具使用：邮件健康检查器和批量发送者检查器。

许可证

MIT