Skip to main content
Glama
GuardianShield

GuardianShield

by sparkvibe-io

GuardianShield

PyPI version Python License Tests

Universelle KI-Sicherheitsschicht – ein Open-Source-MCP-Server für Code-Scanning, PII-Erkennung, Prompt-Injection-Abwehr, Geheimnis-Erkennung, Abhängigkeitsprüfung und Audit-Logging.

Null Abhängigkeiten · 27 MCP-Tools · 5 Sicherheitsprofile · 108+ Erkennungsmuster

Funktionen

  • Code-Schwachstellenscan – SQL-Injection, XSS, Command-Injection, Path Traversal mit CWE-IDs und automatischen Korrekturmaßnahmen

  • Zeilenübergreifende Datenflussanalyse – DeepEngine verfolgt kontaminierte Daten von Quellen zu Senken über mehrere Zeilen hinweg mittels AST-basierter Taint-Propagation (Python) und Regex (JS/TS)

  • Abhängigkeitssicherheit – Versionsbewusster CVE-Abgleich gegen OSV.dev für PyPI-, npm-, Go- und Packagist-Ökosysteme

  • Manifest-Parsing – Automatische Erkennung von 11 Formaten (requirements.txt, package.json, yarn.lock, go.mod, composer.json und mehr)

  • Prompt-Injection-Abwehr – 9+ Erkennungsmuster für Anweisungsüberschreibung, Rollen-Hijacking, ChatML-Injection

  • PII-Erkennung – E-Mail, SSN, Kreditkarte, Telefon, IP – mit automatischer Schwärzung in den Ergebnissen

  • Geheimnis-Erkennung – AWS-Schlüssel, GitHub-Tokens, Stripe-Schlüssel, JWTs, Passwörter, Verbindungszeichenfolgen

  • Sicherheitsprofile – 5 integrierte Profile (Allgemein, Bildung, Gesundheitswesen, Finanzen, Kinder)

  • Audit-Logging – SQLite-gestützte Scan-Historie mit Ergebnisabruf und Filterung

Related MCP server: Cybrium MCP Server

Installation

pip install guardianshield

Schnellstart

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

# Or run directly
guardianshield-mcp

Editor-Integration

# 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-Tools

Scannen

Tool

Beschreibung

scan_code

Quellcode auf Schwachstellen und hartcodierte Geheimnisse scannen

scan_file

Eine einzelne Datei scannen (Sprache wird automatisch anhand der Endung erkannt)

scan_directory

Ein Verzeichnis rekursiv mit Filterung und Fortschritts-Streaming scannen

scan_input

Benutzer-/Agenteneingabe auf Prompt-Injection-Versuche prüfen

scan_output

KI-Ausgabe auf PII-Lecks und Inhaltsverstöße prüfen

check_secrets

Hartcodierte Geheimnisse und Anmeldedaten erkennen

scan_files

Mehrere Dateien in einem Aufruf scannen

scan_diff

Unified-Diff parsen und nur hinzugefügte Zeilen scannen

Abhängigkeitssicherheit

Tool

Beschreibung

check_dependencies

Pakete auf bekannte CVEs via OSV.dev prüfen (PyPI, npm, Go, Packagist)

sync_vulnerabilities

Die lokale OSV-Schwachstellendatenbank synchronisieren

parse_manifest

Jede unterstützte Manifestdatei (11 Formate) in Abhängigkeitsobjekte parsen

scan_dependencies

Ein Verzeichnis nach Manifestdateien durchsuchen und alle Abhängigkeiten auf Schwachstellen prüfen

Fehlalarm-Management

Tool

Beschreibung

mark_false_positive

Einen Fund als Fehlalarm markieren (markiert zukünftige Treffer)

list_false_positives

Aktive Fehlalarm-Einträge mit optionalem Filter auflisten

unmark_false_positive

Einen Fehlalarm-Eintrag anhand des Fingerabdrucks entfernen

Engine-Management

Tool

Beschreibung

list_engines

Verfügbare Analyse-Engines mit Fähigkeiten auflisten

set_engine

Aktive Analyse-Engines für das Code-Scannen festlegen

Drei Engines sind integriert: regex (zeilenweises Muster-Matching, standardmäßig aktiviert), deep (zeilenübergreifende Taint-Verfolgung) und semantic (strukturbewusste Konfidenzanpassung).

CI- & Entwickler-Workflow

Tool

Beschreibung

export_sarif

Ergebnisse als SARIF 2.1.0 JSON für GitHub Code Scanning und CI exportieren

save_baseline

Aktuelle Ergebnisse als Baseline für Delta-Scans speichern

scan_with_baseline

Code scannen und nur neue Ergebnisse im Vergleich zur Baseline melden

check_quality_gate

Ergebnisse gegen Schweregrad-Schwellenwerte prüfen (bestanden/fehlgeschlagen/warnung)

scan_files

Mehrere Dateien in einem Aufruf scannen

scan_diff

Unified-Diff parsen und nur hinzugefügte Zeilen scannen

Konfiguration & Dienstprogramme

Tool

Beschreibung

get_profile

Aktuelle Sicherheitsprofil-Konfiguration abrufen

set_profile

Sicherheitsprofil wechseln (allgemein, bildung, gesundheitswesen, finanzen, kinder)

test_pattern

Ein Regex-Muster gegen Beispielcode testen (für benutzerdefinierte Musterentwicklung)

audit_log

Das Sicherheits-Audit-Log abfragen

get_findings

Frühere Ergebnisse mit Filtern abrufen

shield_status

Status, Konfiguration und OSV-Cache-Statistiken abrufen

Konfiguration

Umgebungsvariablen setzen, um das Verhalten anzupassen:

Variable

Beschreibung

Standard

GUARDIANSHIELD_PROFILE

Standard-Sicherheitsprofil

general

GUARDIANSHIELD_AUDIT_PATH

Pfad zur SQLite-Audit-Datenbank

~/.guardianshield/audit.db

GUARDIANSHIELD_DEBUG

Debug-Logging aktivieren (1)

deaktiviert

Dokumentation

Vollständige Dokumentation: sparkvibe-io.github.io/GuardianShield

Lizenz

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