このプロジェクトについて

SkillGuardは、コーディングエージェントにスキルやMCPサーバーをインストールする人々のためのセキュリティツールです。使用前にこれらの拡張機能をスキャンし、各検出結果の根拠を報告し、適切なフックを公開するホスト上でリスクのあるツールや未レビューのツールをブロックできます。 チェック内容 スキャナは、隠された指示、認証情報の窃取、データ漏洩、安全でないダウンロード、破壊的なコマンド、難読化、永続化動作を探します。MCPサーバーには構造チェックが追加されます:安全でない起動チェーン、平文の認証情報、不審なエンドポイント、安全でないトランスポート、固定されていないランタイム。検出結果にはファイル、場所、重大度、理由が含まれ、人間が最終判断を下せます。プロジェクトは、検出結果が判断を支援するものであり、安全性を保証するものではないと明記しています。 仕組み ディスカバリは、グローバル、プロジェクト、プラグインのスキルと設定済みのMCPサーバーを見つけます。静的スキャンは、コマンド、引数、エンドポイント、環境変数名、ヘッダー名からMCPサーバーの編集済み表現を構築します。サーバーを起動することはありません。シークレット値は、インライン認証情報を特定するためだけにメモリ内で読み取られ、検出結果、キャッシュファイル、履歴には書き込まれません。結果は正規化され、高速なフック判断のためにJSONとしてキャッシュされ、スキャン履歴とオプションのアクティビティ記録のためにSQLiteに保存されます。 ランタイム保護 サポートされているサーフェスでは、各ツール呼び出しが進行する前に最新のスキャンと比較されます。未スキャン、キャッシュ欠落、スキャン後の変更、重大/高リスクの検出対象は、承認されるまでブロックされます。クリーンな対象は許可され、明示的にスキップされた対象はリマインダー付きで許可されます。Claude CodeはスキルとMCPツールの両方をゲートできます。Codexは、インストールされたフックが信頼された後、MCPツール呼び出しをゲートできますが、Codexは現在スキルの読み込みをフックイベントとして公開していません。MCPポリシーはデフォルトで強制に設定され、警告またはオフに設定でき、単一プロセス用の環境変数オーバーライドがあります。 インターフェースとインストール Claude Codeユーザーは、マーケットプレイスからプラグインとしてインストールします。Codexおよびターミナルユーザーは、シェルスクリプトでインストールし、Codexプラグインを追加します。編集可能なPythonインストールにより、skillguardおよびskillguard-hookエントリポイントが公開されます。リポジトリアダプタは、Cursor、Windsurf、Gemini CLI、GitHub Copilotコーディングエージェント、Jules、Aider、goose、opencode、Zed、Warp、Junieを含む13のエージェントサーフェス向けのガイダンスをインストールします。これらのアダプタは、ホストが同等のフックを提供しない限り、自動的な強制ではなくワークフローガイダンスを提供します。 エンジン 必須依存関係リストは意図的に空です。ローカルエンジンはオフラインで決定的です。MCP構造エンジンはMCPターゲットに自動的に適用されます。オプションのエンジンは、Cisco AI Skill Scannerルール、SkillAuditリモート分析、またはSnykエージェントスキャンのセマンティック分析を追加します。各エンジンは可用性チェックの背後にあり、依存関係、トークン、ネットワークアクセスが欠落している場合は、報告されたスキップに低下します。リモートエンジンを選択すると、スキャン資料がそのプロバイダーに送信される可能性があり、ライブMCPイントロスペクションはサーバーを起動または接続するため、両方とも明示的なオプトインの選択です。 レビューワークフロー コマンドは、インベントリスキャン、簡潔なキャッシュ済みリスクサマリー、ターゲットごとの対話型レビュー、ターゲットごとのタイムライン、履歴、アクティビティビューをカバーします。レビュー済みの検出結果は、承認、誤検知としてマーク、または表示可能なリマインダー付きでスキップできます。レビューの処分は、新しいスキャンがカバーする証拠を変更したときにクリアされ、ドキュメントは拡張機能のインストール、更新、編集後の再スキャンを強調しています。 プライバシーとテスト このツールはローカルファーストです:ローカルエンジン、MCP構造エンジン、判定キャッシュ、トリアージファイル、SQLite履歴はマシン上に残ります。テストスイートはスキャナをセキュリティ境界として扱い、悪意のあるフィクスチャと無害なフィクスチャ、真陽性/偽陽性のパターンペア、Unicode難読化と出力スプーフィング、キャッシュ破損と陳腐化、MCP編集とシークレット非永続化、統合パッケージングをカバーします。READMEは、説明するスナップショットで313の合格テストを報告しています。 ライセンス SkillGuardはAGPL-3.0-onlyまたは別の商用ライセンスのデュアルライセンスです。変更されていないスキャナを個人または仕事で実行する場合、商用ライセンスは必要ありません。そのオプションは、異なる条件でソフトウェアを構築または配布する場合に適用されます。