checker-mcp

@oksigenia/checker-mcp

MCP サーバーとして公開される、ドメインのセキュリティとプライバシーのチェッカーです。すべてお使いのマシン上で実行され、テレメトリの送信は行わず、Google ではなく Cloudflare DoH を通じて DNS を解決します。

任意の MCP クライアントにドメインのスキャンを依頼すると、証明書、メール認証、DNS とインフラ、Web セキュリティヘッダーを対象とした採点済みレポートが返されます。失敗した項目には、わかりやすい修正方法も示されます。

他との違い

• ローカルファースト。 サーバーは stdio 経由で動作し、DNS-over-HTTPS、HTTP、RDAP、TLS の検索を独自に実行します。ネットワーク通信はチェックに必要なものだけです。
• テレメトリなし。 分析も、ホームへの通信も、第三者のスコアリングサービスもありません。
• デフォルトでプライバシーを保護。 DNS の問い合わせ先は Google ではなく Cloudflare DoH で、レピュテーションチェックには Cloudflare のマルウェア／フィッシング用リゾルバーを使用します。
• フリーソフトウェア。 GPL-3.0-or-later のライセンスで提供されています。閲覧、実行、変更、セルフホストが可能です。

ツール

サーバーは 3 つのツールを公開します。

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" }

チェック項目

4 つのカテゴリーにまたがる 17 のチェックを実施し、0〜100 点で採点します。

カテゴリー	チェック ID	検証内容
ssl	ssl	SSL/TLS 証明書の有効性と有効期限
email	spf	SPF レコードの有無と、許可範囲が広すぎないこと
email	dmarc	DMARC ポリシーとレポート機能
email	dkim	DKIM 署名（一般的なセレクターを調査）
email	mta_sts	SMTP ダウングレード攻撃に対する MTA-STS
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 で実行

コンテナとしてビルドして実行します。MCP は stdio 経由で通信するため、ポートではなく、クライアントの標準入力／標準出力に接続して実行してください（-i）。

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

言語

レポートはスペイン語と英語で表示されます。OKSIGENIA_LANG（es または en）を設定してデフォルトの言語を指定するか、各ツール呼び出しで lang を渡してください。デフォルトは英語です。

プライバシー

お使いのマシンから外部に送信される情報は、スキャン対象のドメイン名だけです。送信先は次のとおりです。

• DNS とレピュテーションの確認先：Cloudflare DoH（cloudflare-dns.com）と Cloudflare のセキュリティリゾルバー
• 登録情報と WHOIS プライバシーデータの確認先：パブリック RDAP（rdap.org）
• プリロード状況の確認先：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 サーバーです。エンジンのキーを指定された言語に変換し、3 つのツールを公開します。

PR の流れについては、CONTRIBUTING.md をご覧ください。

ライセンス

GPL-3.0-or-later © Oksigenia SL