dnsprobe

dnsprobe

dnsprobe は、無料でAPIキー不要の intodns.ai 公開 API を使って、DNS とメールセキュリティの診断を実行します。ドメインの包括的なスキャン、DNS ルックアップ、DNSSEC 検証、伝播チェック、WHOIS/RDAP、メール認証スタック（SPF（フラット化を含む）、DKIM の検出、DMARC、BIMI、MTA-STS、ブラックリストチェック）に対応しています。また、DMARC 集計レポートと生メールをローカルで解析し、HTTP セキュリティヘッダーセットもローカルで生成します。1 つのバイナリで、コマンドラインインターフェースと stdio MCP サーバーを提供します。

これはラベル付きのコアサブセットです。上流 README のツール一覧に記載されたツールのうち、21 個が実装されています。実装されていないツールは、nis2_quickscan、get_everything_report、create_report_snapshot、get_report_snapshot、start_deep_scan、get_deep_scan_status、cancel_deep_scan、check_tlsa_dane、check_smtp_tls、check_fcrdns、check_sender_requirements、create_email_test、get_email_test、poll_email_test、explain_issue、generate_dns_fix、check_http3、get_hall_of_fame、read_llm_discovery、get_citation_guidance、scan_csp です。（上流 README の見出しではツール数を 45 としていますが、6 つの表に記載されているのは 42 個です。）

APIキーは不要です。サイトのベース URL は DNSPROBE_SITE_URL で上書きできます。設定されていない場合、呼び出し先は https://intodns.ai です。上流のエンドポイントパスは、サイトで確認できる /api/... の慣例に基づく再構成です。公開仕様に記載されているのはツール名と説明であり、パスではありません。

インストール

npx @reneturcios/dnsprobe get_health

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/dnsprobe

コンテナはデフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

サブコマンドは MCP ツール名に対応しています。

dnsprobe scan_domain example.com
dnsprobe lookup_dns example.com --type MX
dnsprobe validate_dnssec example.com
dnsprobe whois_lookup example.com
dnsprobe check_spf example.com
dnsprobe check_email_security example.com
dnsprobe analyze_security_headers https://example.com
dnsprobe generate_security_headers --preset strict --format nginx
dnsprobe get_health
dnsprobe get_pdf_report_link example.com

dnsprobe --version

コマンドは、上流の JSON ペイロード、ローカルで計算した結果、または生成したリンクを出力します。終了コードは、成功時が 0、呼び出し失敗時（上流 API エラーを含む）が 1、使用方法のエラー時が 2 です。

ネットワークを呼び出さないツールが 5 つあります。parse_dmarc_report は DMARC 集計（RUA）XML レポートを解析し、構造化されたメタデータ、ポリシー、レコードごとの SPF/DKIM/DMARC 結果、およびメッセージ合計を出力します。analyze_raw_email は生 MIME ヘッダー（折り返し解除を含む）を解析し、Authentication-Results から SPF/DKIM/DMARC の判定結果を抽出して、Received のホップ数を数えます。generate_security_headers は、recommended、strict、report-only のプリセットからヘッダーセットを生成し、生のヘッダー、または nginx、Apache、Caddy、Cloudflare、_headers の設定として出力します。get_pdf_report_link と get_badge_link は {base}/api/pdf/{domain} と {base}/api/badge/{domain} を生成します。

MCP サーバー

1 つのバイナリで、どちらのインターフェースも提供します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/dnsprobe mcp

MCP クライアントの設定：

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

サーバーが別の intodns.ai 互換ホストを参照するようにするには、このサーバーのクライアントの env に DNSPROBE_SITE_URL を追加してください。

ツール

ツール	入力	戻り値
scan_domain	domain	グレード、スコア、DNS／メール／セキュリティの結果、問題点、推奨事項。
lookup_dns	domain、省略可能な type	ドメインの DNS レコード。
validate_dnssec	domain	DNSSEC チェーン、DS／DNSKEY、アルゴリズムの検証結果。
check_dns_propagation	domain	グローバルリゾルバー全体での伝播状況。
whois_lookup	query	ドメインまたは IP の WHOIS／RDAP データ。
check_spf	domain	SPF の解析、ルックアップグラフ、検証結果。
flatten_spf	domain	SPF グラフをリテラルの ip4／ip6 メカニズムにフラット化したもの。
discover_dkim	domain	検出された DKIM セレクター。
check_dmarc	domain	DMARC の解析とポリシー検証。
parse_dmarc_report	xml	DMARC 集計レポートの構造化データ（ローカルで解析）。
check_bimi	domain	BIMI の DNS、ロゴ URL、VMC／CMC の準備状況。
check_mta_sts	domain	MTA-STS の DNS とポリシーファイルの検証。
check_blacklist	domain	ドメインのメールサーバーのブラックリスト登録状況。
check_email_security	domain	スコアと問題点を含む、SPF／DKIM／DMARC／ブラックリストの包括的なチェック。
analyze_raw_email	raw	生メールのヘッダーと認証の分析（ローカルで実行）。
analyze_security_headers	url	稼働中のサイトにある HTTP セキュリティヘッダーと不足しているヘッダー。
generate_security_headers	省略可能な preset、format	生成されたセキュリティヘッダー一式と設定スニペット（ローカルで生成）。
get_health	（なし）	API、キャッシュ、ランタイムのヘルス状態。
get_stats	（なし）	公開されているスキャン／チェックのカウンター。
get_pdf_report_link	domain	{base}/api/pdf/{domain} の URL（ローカルで生成）。
get_badge_link	domain	{base}/api/badge/{domain} の URL（ローカルで生成）。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。