checker-mcp

@oksigenia/checker-mcp

一个通过 MCP 服务提供的域名安全与隐私检查器。它完全在你的机器上运行，不会发送任何遥测请求，并通过 Cloudflare DoH 而非 Google 解析 DNS。

让任意 MCP 客户端扫描一个域名，即可获得一份评分报告，涵盖证书、电子邮件身份验证、DNS 与基础设施以及 Web 安全标头，并为任何未通过的项目提供简单的修复建议。

与众不同之处

• 本地优先。 服务通过 stdio 运行，并自行执行 DNS-over-HTTPS、HTTP、RDAP 和 TLS 查询。唯一的网络流量就是这些检查本身。
• 零遥测。 没有分析、没有回传、没有第三方评分服务参与。
• 默认保护隐私。 DNS 请求发往 Cloudflare DoH，而不是 Google；信誉检查使用 Cloudflare 的恶意软件／网络钓鱼解析器。
• 自由软件。 采用 GPL-3.0-or-later 许可。阅读、运行、修改或自行托管。

工具

该服务提供三个工具。

check_domain

扫描域名或 URL，并返回基于实时检查的评分报告。

// arguments
{
  "domain": "example.com",          // bare domain or full URL
  "categories": ["ssl", "email"],   // optional subset; defaults to all
  "format": "report",               // "report" (default) or "json"
  "lang": "en"                      // "es" or "en"
}

list_checks

按类别列出所有检查，并说明每项检查的重要性。

{ "lang": "en" }

explain_check

说明指定 ID 的单项检查、它的重要性，以及如何修复未通过的问题。

{ "check_id": "dmarc", "lang": "en" }

检查项目

四个类别共包含十七项检查，并按权重计算为 0-100 分。

类别	检查 ID	验证内容
ssl	ssl	SSL/TLS 证书有效性和到期时间
email	spf	是否存在 SPF 记录，以及其权限是否过于宽泛
email	dmarc	DMARC 策略和报告
email	dkim	DKIM 签名（探测常见选择器）
email	mta_sts	MTA-STS 是否能防范 SMTP 降级攻击
email	mx	邮件投递所需的 MX 记录
email	bimi	BIMI 品牌标识记录和 VMC
dns	dnssec	区域是否启用 DNSSEC 签名
dns	ptr	PTR／正向确认反向 DNS
dns	caa	是否通过 CAA 记录限制证书签发
dns	blacklist	恶意软件／网络钓鱼信誉
dns	expiry	域名注册到期时间
dns	whois_redact	WHOIS/RDAP 个人数据是否已隐藏
web	headers	HTTP 安全标头（HSTS、CSP、X-Frame-Options，……）
web	csp	Content-Security-Policy 的质量
web	web_tech	CMS／服务器版本和 API 暴露情况
web	hsts_preload	是否处于 HSTS 预加载列表中

运行 list_checks 查看完整说明，或运行 explain_check 逐项查看。

安装

使用 npx 直接从 npm 运行：

npx @oksigenia/checker-mcp

在 Claude Code 中注册：

claude mcp add oksigenia-checker -- npx -y @oksigenia/checker-mcp

或者将其添加到任意 MCP 客户端配置中（适用于 Claude Desktop、Claude Code 或任意 MCP 客户端）：

{
  "mcpServers": {
    "oksigenia-checker": {
      "command": "npx",
      "args": ["-y", "@oksigenia/checker-mcp"],
      "env": { "OKSIGENIA_LANG": "en" }
    }
  }
}

然后询问：“检查 example.com 的安全性” 或 “解释 dmarc 检查。”

使用 Docker 运行

将其构建并作为容器运行。它通过 stdio 使用 MCP，因此应将其连接到客户端的 stdin/stdout（-i）运行，而不是通过端口运行。

docker build -t oksigenia-checker-mcp .
docker run --rm -i oksigenia-checker-mcp

语言

报告支持以西班牙语和英语呈现。设置 OKSIGENIA_LANG（es 或 en）可更改默认语言，也可以在任何工具调用中传入 lang。默认语言为英语。

隐私

离开你机器的唯一信息是你扫描的域名，它会发送到：

• Cloudflare DoH（cloudflare-dns.com）和 Cloudflare 的安全解析器，用于 DNS 和信誉检查
• 公共 RDAP（rdap.org），用于查询注册信息和 WHOIS 隐私数据
• HSTS 预加载 API，用于查询预加载状态
• 目标网站本身，通过 HTTPS 读取其证书和安全标头

没有遥测、没有分析，也没有第三方评分服务。你的查询信息不会被存储，也不会被传输到其他任何地方。

开发

npm install
npm run build       # tsup -> dist/
npm run typecheck   # tsc --noEmit
npm test            # vitest (hermetic, mocked network)
npm run smoke       # spawn the built server and exercise every tool live

开发监视：npm run dev。

• src/engine.ts — 网络引擎。与语言无关：返回 i18n 键，而非文本。每项检查都能单独容错，runChecks 永远不会抛出异常。
• src/i18n.ts — es/en 词典和 t()。
• src/index.ts — MCP 服务：将引擎键渲染为指定语言，并提供三个工具。

请参阅 CONTRIBUTING.md 了解 PR 流程。

许可证

GPL-3.0-or-later © Oksigenia SL