snyk/agent-scan

Snyk Agent Scan とは？

Snyk Agent Scan は、コンピューター上の エージェント コンポーネント（MCP（モデル制御プロトコル）サーバー、エージェントツール、Claude、Cursor、GitHub Copilot、Gemini CLI などの AI アシスタントが使用する エージェントスキル）を探すコマンドラインセキュリティスキャナーです。次に、これらのコンポーネントに既知の脅威（プロンプトインジェクション、ツールポイズニング、隠れたマルウェアペイロード、ハードコードされたシークレット、その他の危険な動作）がないかチェックします。

仕組み（高レベル）

発見 – ツールはファイルシステム（システム全体、ユーザーごと、プロジェクト、プラグインの場所）を走査し、サポートされているエージェントの設定ファイルを自動的に見つけます。各エージェントが macOS、Linux、Windows で MCP 定義とスキルファイルを保存する場所を認識しています。
オプションの同意 – ローカルコマンドとして実行されるか、リモート URL に接続する MCP サーバーの場合、CLI は各接続の承認を求めます（--dangerously-run-mcp-servers フラグを使用しない限り）。
分析 – 発見されたコンポーネント（シークレットは削除済み）は Snyk のクラウド分析 API に送信され、14〜15 のセキュリティリスクのカタログに対して評価されます。
レポート – CLI は人間が読めるレポート（または JSON）を出力し、各リスクをスコアリングして影響を受けるコンポーネントをリストします。出力形式は v0.5 の「問題コード」から v0.6 のリスクベースのスコアリングシステムに変更されました。

主な機能

機能	説明
自動発見	多くのエージェント（Claude、Cursor、VS Code、Copilot、Gemini、Windsurf など）の MCP 設定、ツール、スキルファイルを OS をまたいで見つけます。
リスクカタログ	プロンプトインジェクション、信頼できないコンテンツ、プライベートデータの露出、破壊的な機能、悪意のあるコード、シークレット漏洩、疑わしいダウンロードなどを検出します。
2 つの出力スタイル	v0.5 – 問題コードリスト（非推奨予定）。v0.6+ – 数値スコア付きのリスク指標。
スタンドアロンバイナリと `uvx` インストール	npm パッケージはありません。Python ベースの `uvx` ランナーまたは事前ビルドされたバイナリをダウンロードして実行します。
バックグラウンド/MDM モード	エンタープライズ全体に展開して定期的に実行し、結果を Snyk Evo にプッシュできます。
安全警告	MCP サーバーへの明示的な同意、サンドボックスの推奨、クラウドメタデータエンドポイントを回避するためのネットワークアドレスフィルタリング。
検証	バイナリの整合性のために、GPG 署名付きリリースチェックサムと SBOM が提供されます。

誰が使うべきか？

セキュリティチーム – 従業員のマシン上の AI エージェントサプライチェーンの可視性が必要な場合。
開発者 – カスタムエージェントスキルを構築または保守し、公開前にローカルで検証したい場合。
エンタープライズ – Snyk Evo を使用してフリート全体のエージェント関連リスクを監視している場合。

はじめに（クイックステップ）

Snyk アカウントを作成し、API トークンをコピーします。
トークンをエクスポート：export SNYK_TOKEN=your‑api‑token。

スキャナーを実行 – 次のいずれか：

# uv を使用（推奨）
uvx snyk-agent-scan@latest               # マシン全体
uvx snyk-agent-scan@latest ~/.vscode/mcp.json   # 特定の設定

または、GitHub リリースページからバイナリをダウンロードして実行します。

同意プロンプトを確認 – 接続される MCP サーバーがある場合。
生成されたレポートを読む – 高スコアのリスクは、パッチ適用、削除、再設定が必要なコンポーネントを示します。

制限と注意事項

CLI 出力は実験的です。Snyk はリリース間でのフィールド名やリスクスコアの安定性を保証しません。
MCP 設定のスキャンはコマンドを実行したり、外部ネットワーク呼び出しを行ったりする可能性があります – 信頼できないスキャンはサンドボックス内で実行してください。
発見テーブルにリストされているエージェントのみがサポートされています。新しいエージェントは明示的な追加が必要です。
バックグラウンドスキャンは自動的にリモート MCP サーバーに接続します。--dangerously-run-mcp-servers フラグは信頼できる環境でのみ使用してください。

詳細情報

技術レポート（エージェントスキルの脅威について）：.github/reports/skills-report.pdf。
CLI リファレンス：docs/cli-reference.md。
リスク定義：docs/risks.md（v0.6+）および docs/issue-codes.md（v0.5）。
バイナリ検証ガイドは README の Verifying Standalone Binaries セクションにあります。

上記の情報はすべてプロジェクトの README から直接取得したものであり、追加の機能は推測されていません。