Skip to main content
Glama
GuardianShield

GuardianShield

by sparkvibe-io

GuardianShield

PyPI version Python License Tests

ユニバーサルAIセキュリティレイヤー — コードスキャン、PII検出、プロンプトインジェクション防御、シークレット検出、依存関係監査、監査ログのためのオープンソース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つの組み込みプロファイル(一般、教育、医療、金融、子供)

  • 監査ログ — SQLiteベースのスキャン履歴、検出結果の取得とフィルタリング

Related MCP server: Cybrium MCP Server

インストール

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

複数ファイルを一度にスキャン

scan_diff

unified 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

検出結果をSARIF 2.1.0 JSONとしてエクスポート(GitHub Code ScanningおよびCI向け)

save_baseline

現在の検出結果をデルタスキャンのベースラインとして保存

scan_with_baseline

コードをスキャンし、ベースラインと比較して新しい検出結果のみを報告

check_quality_gate

重大度しきい値に対して検出結果を評価(pass/fail/warn)

scan_files

複数ファイルを一度にスキャン

scan_diff

unified diffを解析し、追加行のみをスキャン

設定 & ユーティリティ

ツール

説明

get_profile

現在のセーフティプロファイル設定を取得

set_profile

セーフティプロファイルを切り替え(一般、教育、医療、金融、子供)

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

Available Tools

27 tools
audit_logB

Query the security audit log. Returns recent scan events with timestamps, scan types, finding counts, and input hashes.

Inputs: limit, scan_type.

check_dependenciesC

Check package dependencies for known vulnerabilities using the OSV.dev database. Provide a list of packages with names, versions, and ecosystems (PyPI or npm).

Inputs: dependencies (required).

check_quality_gateA

Scan code and evaluate findings against configurable severity thresholds. Returns a pass/fail/warn verdict suitable for CI pipelines. Exit codes: 0=pass, 1=fail.

Inputs: code (required), fail_on, warn_on, language, +2 more.

check_secretsA

Dedicated secret and credential detection. Scans text for AWS keys, GitHub tokens, Stripe keys, private keys, JWTs, Slack tokens, passwords, connection strings, Google API keys, and more. All matched secrets are redacted in findings.

Inputs: text (required), file_path.

export_sarifA

Export scan findings as SARIF 2.1.0 JSON for GitHub Code Scanning, VS Code, and CI integration

Inputs: code (required), language (required), engines, file_path.

get_findingsA

Retrieve past security findings from the audit database with optional filters by type, severity, or audit ID.

Inputs: limit, audit_id, severity, finding_type.

get_profileA

Get the current safety profile configuration including scanner settings and blocked content categories.

Inputs: no named parameters.

list_enginesA

List available analysis engines with their capabilities and enabled status. Returns each engine's name, whether it is enabled in the current profile, and its capabilities.

Inputs: no named parameters.

list_false_positivesB

List active false positive records. Shows findings that have been marked as false positives, with optional filtering by scanner.

Inputs: limit, scanner.

mark_false_positiveB

Mark a security finding as a false positive. The finding will be flagged in future scans, and similar patterns at other locations will be annotated as potential false positives.

Inputs: finding (required), reason.

parse_manifestB

Parse a dependency manifest file into a structured list of dependencies. Auto-detects format from the filename. Supports: requirements.txt, package.json, pyproject.toml, package-lock.json, yarn.lock, pnpm-lock.yaml, Pipfile.lock, go.mod, go.sum, composer.json, composer.lock.

Inputs: content (required), filename (required).

save_baselineA

Scan code and save the findings as a baseline JSON file. On subsequent scans with scan_with_baseline, only NEW findings (not in the baseline) are reported.

Inputs: code (required), language, file_path, output_path.

scan_codeB

Scan source code for security vulnerabilities (SQL injection, XSS, command injection, path traversal) and hardcoded secrets/credentials. Returns a list of findings with severity, type, and remediation guidance.

Inputs: code (required), engines, language, file_path.

scan_dependenciesA

Recursively scan a directory for manifest/lockfiles (requirements.txt, package.json, go.mod, composer.json, etc.), parse dependencies, and check them for known vulnerabilities using the OSV.dev database.

Inputs: path (required), exclude.

scan_diffA

Scan a unified diff (e.g. from git diff) for vulnerabilities. Only added lines are scanned; findings have correct line numbers and file paths from the diff context.

Inputs: diff (required).

scan_directoryA

Recursively scan a directory for vulnerabilities and secrets. Supports extension filtering, exclude patterns, and reports progress. Returns all findings across all scanned files.

Inputs: path (required), exclude, extensions.

scan_fileA

Scan a single source file for vulnerabilities and secrets. Auto-detects language from file extension. Returns findings with line numbers, severity, CWE IDs, and remediation.

Inputs: path (required), language.

scan_filesB

Scan multiple files in one call. Returns findings grouped by file with a summary of total findings.

Inputs: files (required).

scan_inputA

Check user or agent input for prompt injection attempts. Detects instruction override, role hijacking, system prompt extraction, delimiter abuse, ChatML injection, jailbreak keywords, and encoding evasion.

Inputs: text (required).

scan_outputA

Check AI-generated output for PII leaks (email, SSN, credit card, phone, IP) and content policy violations (violence, self-harm, illegal activity). PII is automatically redacted in findings.

Inputs: text (required).

scan_with_baselineA

Scan code and compare against a saved baseline, returning only NEW findings that are not in the baseline. Use save_baseline first to create a baseline.

Inputs: code (required), language, file_path, baseline_path.

set_engineB

Set which analysis engines are active for code scanning. Accepts a list of engine names to enable for the current session. Available engines can be listed with list_engines.

Inputs: engines (required).

set_profileA

Switch to a different safety profile. Available profiles: general, education, healthcare, finance, children. Each profile adjusts scanner sensitivity and blocked categories.

Inputs: name (required).

shield_statusA

Get GuardianShield health and configuration status including active profile, enabled scanners, and audit statistics.

Inputs: no named parameters.

sync_vulnerabilitiesA

Sync the local OSV vulnerability database for a given ecosystem. Call this to update the cache before checking dependencies.

Inputs: ecosystem (required), packages.

test_patternA

Test a regex pattern against sample code. Returns match details including positions and matched text. Useful for developing and debugging custom vulnerability patterns.

Inputs: regex (required), sample (required), language.

unmark_false_positiveA

Remove a false positive record by its fingerprint. The finding will no longer be flagged in future scans.

Inputs: fingerprint (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 27 tools

    Disambiguation3/5

    Several scan tools overlap in purpose: scan_file, scan_code, scan_directory, scan_files, and check_secrets all detect vulnerabilities and secrets. scan_input and scan_output are distinct, but the boundaries between the code scanning tools are blurry, potentially causing selection errors.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern with underscores. A few deviate with prepositions (scan_with_baseline) but overall the naming is predictable and readable.

    Tool Count3/5

    With 27 tools, the server is feature-rich but borderline heavy. Each tool serves a distinct function for code analysis, dependency checking, and security management, but the count is slightly above the ideal range for ease of agent navigation.

    Completeness4/5

    The tool set covers nearly all aspects of security scanning: static analysis, input/output checking, dependency scanning, false positive management, baselines, quality gates, and export. Missing advanced features like custom profile creation or result deletion, but these are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Security middleware for LLM apps and AI agent pipelines. Detects prompt injection attacks (22 signatures, 7 languages) and anonymizes PII (17 entity types). Deterministic, sub-25ms, GDPR Art.30 compliant.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides AI coding assistants with real-time security scanning superpowers, including SAST, secrets detection, dependency CVE scanning, and web vulnerability assessment.
      15 npm
      Apache 2.0