vulnerability-scanner

@guardbee/mcp-vulnerability-scanner

🇬🇧 English | 🇹🇷 Türkçe | 🇨🇳 中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇧🇷 Português | 🇪🇸 Español | 🇩🇪 Deutsch

Claudeとの会話からGuardBeeのセキュリティスキャンを直接実行できます。OWASPチェックを実行し、検出結果を照会して、AIに修正の推奨事項を優先順位付けさせることができます。

テレメトリーはデフォルトでオフです。GUARDBEE_TELEMETRY=1を設定すると、サーバー、ツール、成功状況、所要時間、およびファイルパスなどの短いパラメーター値が送信されます。長い文字列や、content、token、passwordなどのフィールドはプレースホルダーに置き換えられます。詳細は@guardbee/mcp-telemetryを参照してください。

GuardBee APIキーが必要です。 app.guardbee.ai/developersで取得してください。

---

機能

• Claudeからスキャンを実行 — 1つのコマンドで任意のURLに対するGuardBeeスキャンを開始します
• ステータス照会 — スキャンの進行状況と概要の件数をリアルタイムで確認できます
• 検出結果のフィルター — 重大度、スキャンID、またはブランドIDで照会できます
• 修正ガイダンス — すべての検出結果に説明と実行可能な推奨事項が付属します
• スキャンシナリオ — quick、kvkkFocus、gdprFocus、ccpaFocus
• 36個のスキャンモジュール — GuardBeeの全モジュールに対応しています
• 25個の単体テスト — API呼び出しを必要としないテストスイート

---

クイックスタート

npm install -g @guardbee/mcp-vulnerability-scanner

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "guardbee-vulnerability-scanner": {
      "command": "npx",
      "args": ["-y", "@guardbee/mcp-vulnerability-scanner"],
      "env": {
        "GUARDBEE_API_KEY": "gb_..."
      }
    }
  }
}

app.guardbee.ai/developersでAPIキーを取得してください。

---

MCPツール

ツール	説明
start_scan	URLまたはブランドIDのスキャンを開始します。wait=trueの場合は完了まで待機します
get_scan_status	スキャンIDごとのリアルタイムステータスと概要の件数を取得します
list_scans	フィルターを指定してワークスペースのスキャン一覧を取得します
get_findings	重大度／scanId／brandIdでフィルターした検出結果を取得します
scan_and_report	スキャン＋待機を行い、重大／高の検出結果と修正の推奨事項を返します

使用例

Claudeに次のように依頼できます。

「https://example.comをスキャンして、セキュリティレポートを作成してください」

「最近のスキャンを一覧表示してください」

「スキャンclz001の重大な検出結果を表示し、修正方法を説明してください」

「example.comに対してKVKKに重点を置いたスキャンを実行してください」

出力例

⚠️  Security scan complete for https://example.com
   Scan ID  : clz001abc
   🔴 Critical : 2
   🟠 High     : 5
   🟡 Medium   : 8
   🔵 Low      : 3
   ⚪ Info     : 12
   ✅ Passed   : 18

Use get_findings with scanId="clz001abc" to see details and remediation steps.

---

スキャンシナリオ

シナリオ	説明
quick	36個の全モジュール — 包括的な一般スキャン
kvkkFocus	KVKKコンプライアンスモジュールに重点を置きます
gdprFocus	GDPRコンプライアンスモジュールに重点を置きます
ccpaFocus	CCPAコンプライアンスモジュールに重点を置きます

---

環境変数

変数	説明
GUARDBEE_API_KEY	GuardBee APIキー （必須）
GUARDBEE_BASE_URL	カスタムエンドポイント（デフォルト：https://app.guardbee.ai）

---

開発

npm install
npm test          # 25 unit tests
npm run build     # TypeScript compile

---

ライセンス

MIT — GuardBee

フィードバック

ご質問やアイデア、誤検知がありましたら、GitHub Discussionsでスレッドを開始するか、issue を作成してください。GuardBee が役に立った場合は、リポジトリに ⭐ を付けていただくと、ほかの方にも見つけてもらいやすくなります。