affaan-m/agentshield

AI agent security scanner. Detect vulnerabilities in agent configurations, MCP servers, and tool permissions. Available as CLI, GitHub Action, ECC plugin, and GitHub App integration. 🛡️

何を解決するか

AgentShield は、AIエージェントの設定を保護するためのセキュリティ監査ツールであり、特に Claude Code の設定を対象としています。開発者がコミュニティスキルをインストールしたり、MCP（Model Context Protocol）サーバーに接続したり、フックを設定したりする際に、ハードコードされたシークレット、過剰な権限、プロンプトインジェクションの脆弱性が含まれていないかを把握せずに行動するリスクに対処します。これにより、リモートコード実行（RCE）やデータ漏洩を引き起こす可能性が低減されます。

動作方法

AgentShield は .claude/ ディレクトリと関連する設定ファイルをスキャンし、15モジュールにまたがる268のルールライブラリを使用して脆弱性を特定します。以下の主要な領域を分析します：

シークレット検出：Anthropic、OpenAI などのハードコードされたAPIキー、トークン、認証情報の検索。
権限監査：ワイルドカードアクセス（例：Bash(*)）や危険なコマンドに対する拒否リストの欠如をマーク。
フック分析：エージェントフック内のコマンドインジェクション、データ漏洩パターン、リバースシェルの検出。
MCPサーバーのセキュリティ：高リスクサーバー、サプライチェーンリスク（例：npx -y の自動インストール）、不適切なネットワークバインディングの識別。
エージェント設定レビュー：CLAUDE.md およびサブエージェント設定ファイル内のプロンプトインジェクションの表面、隠し指示、危険な自動実行ディレクティブのスキャン。

セキュリティレポート（A～Fのグレード）を提供し、CLIツール、GitHub Action、GitHub Appとして統合可能です。また、Claude Opus を使用した敵対的分析モードもサポートしています。

対象ユーザー

特に Claude Code を使用する開発者やセキュリティエンジニア向けです。エージェント設定やサードパーティ拡張機能が本番環境にデプロイされる前に、そのセキュリティを確保したい方々に最適です。

主な特徴

包括的なルールセット：シークレット、権限、フック、MCPサーバー、エージェントプロンプトをカバーする268のルール。
柔軟な統合：npm（npx）、グローバルインストール、GitHub Action、GitHub App から利用可能。
自動修復機能：--fix フラグにより、ハードコードされたシークレットを環境変数参照に自動置換可能。
文脈認識スコアリング：runtimeConfidence を使用して、実行時設定とテンプレートや例の違いを区別し、ドキュメントによるスコアの不正なペナルティを回避。
サプライチェーン検証：npmレジストリを照会して、MCPパッケージの出自と健全性を確認可能。