GuardianShield
GuardianShield
범용 AI 보안 계층 — 오픈소스 MCP 서버로, 코드 스캐닝, PII 탐지, 프롬프트 인젝션 방어, 시크릿 탐지, 의존성 감사, 감사 로깅을 제공합니다.
종속성 제로 · 27개의 MCP 도구 · 5개의 안전 프로필 · 108개 이상의 탐지 패턴
기능
코드 취약점 스캐닝 — SQL 인젝션, XSS, 명령 인젝션, 경로 순회 탐지 (CWE ID 및 자동 수정 지침 포함)
크로스라인 데이터 흐름 분석 — DeepEngine이 AST 기반 오염 전파(Python) 및 정규식(JS/TS)을 사용하여 여러 라인에 걸쳐 오염된 데이터를 출발지에서 도착지까지 추적합니다.
의존성 보안 — OSV.dev를 통해 PyPI, npm, Go, Packagist 생태계의 버전 인식 CVE 매칭
매니페스트 파싱 — 11가지 형식(requirements.txt, package.json, yarn.lock, go.mod, composer.json 등) 자동 감지
프롬프트 인젝션 방어 — 명령 재정의, 역할 하이재킹, ChatML 인젝션 등 9개 이상의 탐지 패턴
PII 탐지 — 이메일, 주민번호, 신용카드, 전화번호, 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 도구
스캐닝
도구 | 설명 |
| 소스 코드에서 취약점 및 하드코딩된 시크릿 스캔 |
| 단일 파일 스캔 (확장자로 언어 자동 감지) |
| 디렉터리를 재귀적으로 스캔 (필터링 및 진행률 스트리밍 포함) |
| 사용자/에이전트 입력에서 프롬프트 인젝션 시도 확인 |
| AI 출력에서 PII 유출 및 콘텐츠 위반 확인 |
| 하드코딩된 시크릿 및 자격 증명 탐지 |
| 한 번의 호출로 여러 파일 스크리닝 |
| 통합 diff를 파싱하고 추가된 라인만 스캔 |
의존성 보안
도구 | 설명 |
| OSV.dev를 통해 패키지에서 알려진 CVE 확인 (PyPI, npm, Go, Packagist) |
| 로컬 OSV 취약점 데이터베이스 동기화 |
| 지원되는 모든 매니페스트 파일(11가지 형식)을 파싱하여 의존성 객체로 변환 |
| 디렉터리에서 매니페스트 파일을 스캔하고 모든 의존성에서 취약점 확인 |
오탐(False Positive) 관리
도구 | 설명 |
| 발견 항목을 오탐으로 표시 (향후 일치 항목 플래그 지정) |
| 활성 오탐 기록 목록 조회 (선택적 필터 포함) |
| 지문으로 오탐 기록 제거 |
엔진 관리
도구 | 설명 |
| 사용 가능한 분석 엔진 목록 (기능 포함) |
| 코드 스캔을 위한 활성 분석 엔진 설정 |
세 가지 엔진이 내장되어 있습니다: regex (라인별 패턴 매칭, 기본 활성화), deep (크로스라인 오염 추적), semantic (구조 인식 신뢰도 조정).
CI 및 개발자 워크플로
도구 | 설명 |
| GitHub Code Scanning 및 CI용 SARIF 2.1.0 JSON으로 결과 내보내기 |
| 현재 결과를 델타 스캔을 위한 베이스라인으로 저장 |
| 코드를 스캔하고 베이스라인 대비 새로운 결과만 보고 |
| 심각도 임계값에 따른 결과 평가 (통과/실패/경고) |
| 한 번의 호출로 여러 파일 스크리닝 |
| 통합 diff를 파싱하고 추가된 라인만 스캔 |
구성 및 유틸리티
도구 | 설명 |
| 현재 안전 프로필 구성 조회 |
| 안전 프로필 전환 (general, education, healthcare, finance, children) |
| 샘플 코드에 대해 정규식 패턴 테스트 (사용자 정의 패턴 개발용) |
| 보안 감사 로그 조회 |
| 필터를 사용하여 과거 발견 항목 검색 |
| 상태, 구성, OSV 캐시 통계 정보 확인 |
구성
환경 변수를 설정하여 동작을 사용자 지정할 수 있습니다:
변수 | 설명 | 기본값 |
| 기본 안전 프로필 |
|
| SQLite 감사 데이터베이스 경로 |
|
| 디버그 로깅 활성화 ( | 비활성화 |
문서
전체 문서: sparkvibe-io.github.io/GuardianShield
라이선스
Apache 2.0
Available Tools
27 toolsaudit_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
Scored across 27 tools
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.
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.
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.
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
Related MCP Connectors
Security scanner for AI-written code: SAST, secrets, dependencies, IaC, containers and DAST.
Threat modeling, code/cloud/pipeline scanning, shadow-AI discovery, compliance checks and fixes.
Pay-per-call cybersecurity for AI agents: vuln scans, threat intel, compliance, code security.
The WAF for agents. Pattern-based + heuristic firewall scans prompts, RAG documents, tool argume...
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceSecurity 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.-

Cybrium MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceProvides AI coding assistants with real-time security scanning superpowers, including SAST, secrets detection, dependency CVE scanning, and web vulnerability assessment.15 npmApache 2.0- AlicenseNot gradedqualityCmaintenanceProvides cascading content protection for AI coding assistants by detecting and redacting PII, secrets, prompt injection, and system prompt leakage before they reach LLMs.MIT
- AlicenseAqualityDmaintenanceActs as a production-grade safety layer for AI-assisted coding, monitoring Git hygiene, scanning for security issues (PII, secrets, injection), and enabling semantic history search.9MIT