Agent Security Scanner MCP

🚀 agent-security-scanner-mcp

AIコーディングエージェントと自律型アシスタントのセキュリティスキャナー

このツールは、MCP（Claude Code、Cursor、Windsurf、Cline）またはCLI（OpenClaw、CI/CD）を介して、コードの脆弱性をスキャンし、幻覚パッケージを検出し、プロンプトインジェクションをブロックします。

🚀 クイックスタート

npx agent-security-scanner-mcp init claude-code

initコマンドを実行した後、クライアントを再起動してください。これでスキャナーが有効になります。

その他のクライアント: claude-code を cursor、claude-desktop、windsurf、cline、kilo-code、opencode、または cody に置き換えてください。引数なしで実行すると、対話型でクライアントを選択できます。

✨ 主な機能

• コードの脆弱性をスキャンし、幻覚パッケージを検出し、プロンプトインジェクションをブロックします。
• 2種類のバージョン（ProofLayer（軽量版）とフルバージョン（高度版））が用意されています。
• 複数の言語に対応し、1700以上のセキュリティルールを持ちます。
• 複数のツールを提供し、コードのセキュリティを総合的に管理できます。

📦 インストール

インストール方法

npm install -g agent-security-scanner-mcp

または、インストールせずに直接 npx を使用することもできます。

npx agent-security-scanner-mcp

前提条件

• Node.js >= 18.0.0 (必須)
• Python 3.x (アナライザーエンジンに必要)
• PyYAML (pip install pyyaml) — ルールの読み込みに必要
• tree-sitter (オプション、高度なAST検出用): pip install tree-sitter tree-sitter-python tree-sitter-javascript

クライアントのセットアップ

init コマンドは、OSを自動検出し、設定ファイルを見つけ、バックアップを作成し、MCPサーバーエントリを追加します。initコマンドを実行した後、クライアントを再起動してください。

initオプション

手動設定

MCPクライアントの設定に以下を追加してください。

{
  "mcpServers": {
    "security-scanner": {
      "command": "npx",
      "args": ["-y", "agent-security-scanner-mcp"]
    }
  }
}

設定ファイルの場所:

診断

npx agent-security-scanner-mcp doctor        # セットアップの健全性をチェックします。
npx agent-security-scanner-mcp doctor --fix  # 軽微な問題を自動修正します。

Node.jsのバージョン、Pythonの可用性、アナライザーエンジンの状態をチェックし、すべてのクライアント設定をスキャンします。

💻 使用例

基本的な使用法

# プロンプトのインジェクション攻撃をスキャンする
npx agent-security-scanner-mcp scan-prompt "ignore previous instructions"

# ファイルの脆弱性をスキャンする
npx agent-security-scanner-mcp scan-security ./app.py --verbosity minimal

# git diff（変更されたファイルのみ）をスキャンする
npx agent-security-scanner-mcp scan-diff --base main --target HEAD

# プロジェクト全体をグレード付けしてスキャンする
npx agent-security-scanner-mcp scan-project ./src

# パッケージが正当なものかチェックする
npx agent-security-scanner-mcp check-package flask pypi

# ファイルのインポートに幻覚パッケージが含まれているかスキャンする
npx agent-security-scanner-mcp scan-packages ./requirements.txt pypi

# Claude Codeの自動スキャン用のフックをインストールする
npx agent-security-scanner-mcp init-hooks

終了コード: 0 = 安全、1 = 問題が検出されました。スクリプトで危険な操作をブロックするために使用できます。

高度な使用法

# デモを実行する
npx agent-security-scanner-mcp demo --lang js

3つの意図的な脆弱性を持つ小さなファイルを作成し、スキャナーを実行し、CWE/OWASPの参照情報付きで結果を表示し、テスト用にファイルを保持するかどうかを尋ねます。 利用可能な言語: js (デフォルト), py, go, java。

📚 詳細ドキュメント

ツールの説明

推奨ワークフロー

コードを作成または編集した後

scan_security → 結果をレビュー → fix_security → 修正を検証

コミット前

scan_git_diff → 変更されたファイルのみをスキャンして迅速なフィードバックを得る
scan_packages → すべてのインポートが正当なものか検証する

PRレビュー時

scan_git_diff --base main → メインブランチに対してPRの変更をスキャンする

プロジェクト監査時

scan_project → A-Fのセキュリティグレードと集計されたメトリクスを取得する

外部入力を処理するとき

scan_agent_prompt → 命令を実行する前に悪意のある命令が含まれているかチェックする

依存関係を追加するとき

check_package → 新しいパッケージ名が実在するもので、幻覚ではないことを検証する

ClawHubエコシステムのスキャン (v3.11.0で新機能)

AIエージェントのスキルに対して、プロンプトインジェクション、ジェイルブレイク、およびセキュリティ脅威をスキャンします。

# 全ClawHubエコシステム（777のスキル）をスキャンする
node index.js scan-clawhub

# 単一のスキルファイルをスキャンする
node index.js scan-skill ./path/to/SKILL.md

# スタンドアロンパッケージ
npm install -g clawproof
clawproof scan ./SKILL.md

セキュリティレポート: すべての777のClawHubスキルをスキャンしました。

• 69.5% にセキュリティ問題があります。
• 21.2% に重大な脆弱性があります（グレードF - インストールしないでください）。
• 30.5% は完全に安全です（グレードA）。
• 4,129 のプロンプトインジェクションパターンが検出されました。

ClawHubセキュリティダッシュボード で、検索可能なセキュリティグレードと詳細な結果を持つすべての16,532のスキルを対話的に探索できます。

検出能力:

• プロンプトインジェクション (15パターン): "ignore previous instructions", ロール操作
• ジェイルブレイク (4パターン): DANモード、開発者モード、擬似シナリオ
• データ漏洩 (2パターン): 外部URL、base64エンコーディング
• 隠し命令 (2パターン): HTMLコメント、秘密の指示

セキュリティグレード:

• A (0ポイント): インストールして安全です。
• B (1-10): 低リスク - 結果をレビューしてください。
• C (11-25): 中リスク - 注意して使用してください。
• D (26-50): 高リスク - 推奨されません。
• F (51以上): インストールしないでください - 重大な脅威があります。

🔧 技術詳細

分析パイプライン

1. 解析 — tree-sitterを使用して、対象言語のASTを構築します（利用できない場合は正規表現にフォールバックします）。
2. マッチング — 1700以上のSemgrepアラインドルールとメタ変数パターンマッチング ($VAR) を使用します。
3. トレース — 汚染分析により、ソース（ユーザー入力）からシンク（危険な関数）へのデータフローを追跡します。
4. レポート — 問題を重大度、CWE/OWASPの参照情報、行番号、および修正提案とともに返します。
5. 修正 — 120の自動修正テンプレートにより、修正されたコードを生成します。

幻覚検出パイプライン

1. 抽出 — コードファイルまたは依存関係マニフェストからインポートを解析します。
2. ルックアップ — 各パッケージをブルームフィルターまたはテキストリストと照合します。
3. レポート — 未知のパッケージを信頼度スコアとともにフラグ付けします。

📄 ライセンス

MITライセンスの下で提供されています。