Skip to main content
Glama
GuardianShield

GuardianShield

by sparkvibe-io

GuardianShield

PyPI version Python License Tests

Универсальный уровень безопасности для ИИ — сервер MCP с открытым исходным кодом для сканирования кода, обнаружения PII, защиты от инъекций промптов, поиска секретов, аудита зависимостей и ведения журнала аудита.

Ноль зависимостей · 27 инструментов MCP · 5 профилей безопасности · 108+ шаблонов обнаружения

Возможности

  • Сканирование уязвимостей кода — SQL-инъекции, XSS, инъекции команд, обход путей с идентификаторами CWE и автоматическим исправлением

  • Межстрочный анализ потоков данных — DeepEngine отслеживает зараженные данные от источников к стокам через несколько строк с помощью распространения заражений на основе AST (Python) и регулярных выражений (JS/TS)

  • Безопасность зависимостей — Сопоставление CVE с учетом версий через OSV.dev для экосистем PyPI, npm, Go и Packagist

  • Разбор манифестов — Автоматическое обнаружение 11 форматов (requirements.txt, package.json, yarn.lock, go.mod, composer.json и другие)

  • Защита от инъекций промптов — 9+ шаблонов обнаружения переопределения инструкций, перехвата ролей, инъекций ChatML

  • Обнаружение PII — Email, 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

Проверка вывода ИИ на утечки PII и нарушения содержимого

check_secrets

Обнаружение жестко заданных секретов и учетных данных

scan_files

Сканирование нескольких файлов за один вызов

scan_diff

Разбор унифицированного diff и сканирование только добавленных строк

Безопасность зависимостей

Инструмент

Описание

check_dependencies

Проверка пакетов на известные CVE через OSV.dev (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

Установка активных движков анализа для сканирования кода

Три встроенных движка: regex (построчное сопоставление с шаблоном, включен по умолчанию), deep (межстрочное отслеживание заражений) и semantic (корректировка уверенности с учетом структуры).

CI и рабочий процесс разработчика

Инструмент

Описание

export_sarif

Экспорт результатов в формате SARIF 2.1.0 JSON для GitHub Code Scanning и CI

save_baseline

Сохранение текущих результатов в качестве базовой линии для дельта-сканирования

scan_with_baseline

Сканирование кода и отчет только о новых результатах по сравнению с базовой линией

check_quality_gate

Оценка результатов по порогам серьезности (пройдено/не пройдено/предупреждение)

scan_files

Сканирование нескольких файлов за один вызов

scan_diff

Разбор унифицированного 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