GuardianShield

GuardianShield

コードスキャン、PII 検出、プロンプトインジェクション防御、シークレット検出、依存関係の監査、監査ログに対応した、汎用 AI セキュリティレイヤー — オープンソースの MCP サーバーです。

依存関係ゼロ · 27 個の MCP ツール · 5 種類の安全プロファイル · 108 種類以上の検出パターン

機能

• コードの脆弱性スキャン — SQL インジェクション、XSS、コマンドインジェクション、パストラバーサルを検出し、CWE ID と自動修正による修復を提供します
• 行をまたぐデータフロー分析 — DeepEngine は AST ベースの汚染伝播（Python）と正規表現（JS/TS）を使用し、複数行にわたってソースからシンクまで汚染データを追跡します
• 依存関係のセキュリティ — PyPI、npm、Go、Packagist の各エコシステムについて、OSV.dev と照合してバージョンを考慮した CVE マッチングを行います
• マニフェストの解析 — 11 種類の形式（requirements.txt、package.json、yarn.lock、go.mod、composer.json など）を自動検出します
• プロンプトインジェクション防御 — 指示の上書き、ロールの乗っ取り、ChatML インジェクションに対する 9 種類以上の検出パターン
• PII 検出 — メールアドレス、SSN、クレジットカード、電話番号、IP アドレスを検出し、検出結果を自動的にマスキングします
• シークレット検出 — AWS キー、GitHub トークン、Stripe キー、JWT、パスワード、接続文字列を検出します
• 安全プロファイル — 5 種類の組み込みプロファイル（general、education、healthcare、finance、children）
• 監査ログ — 検出結果の取得とフィルタリングに対応した、SQLite ベースのスキャン履歴

インストール

pip install guardianshield

クイックスタート

# Register with Claude Code
claude mcp add guardianshield -- guardianshield-mcp

# Or run directly
guardianshield-mcp

エディターとの統合

# Claude Code
claude mcp add guardianshield -- guardianshield-mcp

# VS Code (.vscode/mcp.json)
{"servers": {"guardianshield": {"type": "stdio", "command": "guardianshield-mcp"}}}

# Cursor (.cursor/mcp.json)
{"mcpServers": {"guardianshield": {"command": "guardianshield-mcp"}}}

# Claude Desktop (claude_desktop_config.json)
{"mcpServers": {"guardianshield": {"command": "guardianshield-mcp"}}}

MCP ツール

スキャン

ツール	説明
scan_code	ソースコードをスキャンし、脆弱性とハードコードされたシークレットを検出します
scan_file	単一ファイルをスキャンします（拡張子から言語を自動検出します）
scan_directory	フィルタリングと進捗のストリーミングに対応し、ディレクトリを再帰的にスキャンします
scan_input	ユーザー／エージェントの入力をチェックし、プロンプトインジェクションの試みを検出します
scan_output	AI の出力をチェックし、PII の漏えいとコンテンツ違反を検出します
check_secrets	ハードコードされたシークレットと認証情報を検出します
scan_files	1 回の呼び出しで複数のファイルをスキャンします
scan_diff	統合 diff を解析し、追加された行のみをスキャンします

依存関係のセキュリティ

ツール	説明
check_dependencies	OSV.dev 経由でパッケージの既知の CVE をチェックします（PyPI、npm、Go、Packagist）
sync_vulnerabilities	ローカルの OSV 脆弱性データベースを同期します
parse_manifest	対応する任意のマニフェストファイル（11 種類の形式）を依存関係オブジェクトに解析します
scan_dependencies	ディレクトリ内のマニフェストファイルを検索し、すべての依存関係の脆弱性をチェックします

誤検知の管理

ツール	説明
mark_false_positive	検出結果を誤検知としてマークします（今後の一致にもフラグを付けます）
list_false_positives	有効な誤検知レコードを一覧表示します（任意のフィルターに対応）
unmark_false_positive	フィンガープリントを指定して誤検知レコードを削除します

エンジンの管理

ツール	説明
list_engines	利用可能な分析エンジンとその機能を一覧表示します
set_engine	コードスキャンに使用する分析エンジンを設定します

3 つのエンジンが組み込みで提供されます。regex（行ごとのパターンマッチング。デフォルトで有効）、deep（行をまたぐ汚染追跡）、semantic（構造を考慮した信頼度の調整）です。

CI と開発者ワークフロー

ツール	説明
export_sarif	GitHub Code Scanning と CI 用に、検出結果を SARIF 2.1.0 JSON としてエクスポートします
save_baseline	差分スキャン用のベースラインとして、現在の検出結果を保存します
scan_with_baseline	コードをスキャンし、ベースラインと比較して新しい検出結果のみを報告します
check_quality_gate	重要度のしきい値に照らして検出結果を評価します（合格／不合格／警告）
scan_files	複数のファイルを 1 回の呼び出しでスキャンします
scan_diff	unified diff を解析し、追加された行のみをスキャンします

設定とユーティリティ

ツール	説明
get_profile	現在の安全プロファイル設定を取得します
set_profile	安全プロファイル（general、education、healthcare、finance、children）を切り替えます
test_pattern	カスタムパターンの開発用に、サンプルコードに対して正規表現パターンをテストします
audit_log	セキュリティ監査ログを照会します
get_findings	フィルターを指定して過去の検出結果を取得します
shield_status	ヘルス状態、設定、OSV キャッシュの統計情報を取得します

設定

環境変数を設定して動作をカスタマイズします。

変数	説明	デフォルト
GUARDIANSHIELD_PROFILE	デフォルトの安全プロファイル	general
GUARDIANSHIELD_AUDIT_PATH	SQLite 監査データベースのパス	~/.guardianshield/audit.db
GUARDIANSHIELD_DEBUG	デバッグログを有効にします（1）	無効

ドキュメント

詳細なドキュメント：sparkvibe-io.github.io/GuardianShield

ライセンス

Apache 2.0