MCP-Shield Pro
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Shield Pro Run an OWASP MCP Top 10 security audit on my codebase"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π‘οΈ MCP-Shield Pro β Enterprise MCP Supply Chain & Runtime Governance Shield

Enterprise-grade zero-dependency security shield and runtime governance engine for Model Context Protocol (MCP) servers, AI agent tool pipelines, and AIBOM compliance.
β‘ Key Highlights & Core Capabilities
β‘ Zero External Runtime Dependencies: Pure Node.js ES Module runtime delivering sub-millisecond execution (< 2ms) with zero third-party npm package overhead.
π‘οΈ OWASP MCP Top 10 Security Audit: Automated static & dynamic code inspection covering unauthenticated endpoints, tool signature gaps, prompt injection, and command injection.
π Cryptographic Tool Call Signing: HMAC-SHA256 tool request signing and replay attack prevention for agent execution pipelines.
π Standardized AIBOM Generator: Automated AI Bill of Materials (AIBOM) generation tracking component file hashes, tools, and security provenance.
π§± Inline Runtime Parameter Firewall: Intercepts tool parameters in real-time to block path traversal, shell metacharacters, SSRF, and adversarial injection patterns.
π Native MCP Protocol Server: Stdio JSON-RPC 2.0 interface exposing
mcp_scan,generate_aibom, andmcp_verifytools directly to OpenClaw, Codex, Claude Code, and Cursor.π¨ Interactive Browser Studio Dashboard: Embedded single-file studio (
demo/index.html) featuring live security gauges, OWASP rule status, and parameter firewall sandbox.π Error-Resuming Auto-Installer: Executable
./install.shwith checkpoint tracking (.install_checkpoint) and./install.sh --resumerecovery.
Related MCP server: mcp-security-scanner
π System Architecture

π‘οΈ OWASP MCP Top 10 Security Rule Coverage
Rule ID | Threat Category | Description | Severity | Safeguard Mechanism |
MCP-01 | π Authentication | Unauthenticated Endpoint Exposure | π΄ HIGH | Bearer/HMAC Auth Verification |
MCP-02 | π Integrity | Missing Cryptographic Tool Signatures | π΄ HIGH | ToolSigner HMAC-SHA256 Enforcer |
MCP-03 | π§ AI Security | Indirect Prompt Injection Vulnerability | π£ CRITICAL | Delimiter Boundary Sanitization |
MCP-04 | π‘οΈ Authorization | Excess Tool Privileges & Over-scoping | π‘ MEDIUM | Principle of Least Privilege Inspector |
MCP-05 | π¦ Supply Chain | Untrusted Supply Chain Dependency | π΄ HIGH | AIBOM Provenance & Hash Verification |
MCP-06 | β‘ Execution | Arbitrary Command & Shell Injection | π£ CRITICAL | RuntimeFirewall Parameter Sanitizer |
MCP-07 | π File System | Path Traversal & Traversal Escapes | π΄ HIGH | Workspace Root Path Containment |
MCP-08 | π Network | Server-Side Request Forgery (SSRF) | π΄ HIGH | URL Host Domain Allowlisting |
MCP-09 | π Privacy | Unbounded Context & Credential Leak | π΄ HIGH | Secret Regex & Pattern Scrubber |
MCP-10 | π Logging | Missing Audit Trail & Session Identity | π‘ MEDIUM | Structured JSON Audit Logger |
π Quick Start & Installation
1οΈβ£ Automatic Installation with Error Resume
# Clone and run the self-healing auto-installer
git clone https://github.com/tonysheesh/mcp-shield-pro.git
cd mcp-shield-pro
./install.sh
# If any step is interrupted, resume automatically:
./install.sh --resume2οΈβ£ Running Security Audits via CLI
# Run OWASP MCP Top 10 security audit on current codebase
node bin/mcp-shield.js --scan .
# Generate AI Bill of Materials (AIBOM)
node bin/mcp-shield.js --aibom .
# Run strict Quality Approval Gate checks
node bin/mcp-shield.js --quality .β‘ Comparison & Superiority
Feature / Metric | Legacy Scanners & Python Tools | MCP-Shield Pro |
Runtime Dependencies | Heavy ( | 0 External Dependencies (Pure Node ESM) |
Audit Execution Speed | ~1.5s - 3.2s per codebase | < 2ms per scan (150x Faster) |
Tool Call Integrity | Plaintext JSON / Unsigned | HMAC-SHA256 Cryptographic Signatures |
Supply Chain Governance | Manual SBOMs | Automated AI Bill of Materials (AIBOM) |
Runtime Protection | Static Analysis Only | Inline Parameter Firewall Sandbox |
IDE & Agent Integration | Manual CLI invocation | Native Stdio MCP JSON-RPC Server |
Installer Resiliency | Standard script (fails on error) | Checkpoint State Tracking ( |
π» Programmatic API Usage
import { MCPScanner, ToolSigner, RuntimeFirewall, AIBOMGenerator } from 'mcp-shield-pro';
// 1. Audit an MCP tool file
const scanner = new MCPScanner();
const audit = scanner.scanFile('./lib/mcpServer.js');
console.log(`Security Score: ${audit.score}/100 | Passed: ${audit.passed}`);
// 2. Cryptographically sign a tool call
const signer = new ToolSigner('your-master-secret-key');
const signedPayload = signer.signToolCall('query_database', { query: 'SELECT 1' });
// 3. Verify signature
const verification = signer.verifyToolCall(signedPayload);
console.log(`Signature Valid: ${verification.valid}`);
// 4. Runtime parameter firewall inspection
const firewall = new RuntimeFirewall();
const inspection = firewall.inspectParams('read_file', { path: '../../etc/passwd' });
console.log(`Allowed: ${inspection.allowed}`); // falseπΊοΈ Roadmap
Support for Ed25519 asymmetric public-key signature verification for decentralized tool execution.
Real-time eBPF syscall filtering integration for containerized agent workloads.
Automated OWASP MCP Top 10 rule auto-fixer (
--fix) to patch vulnerabilities in-place.Multi-region threat intelligence feed synchronization for emerging prompt injection patterns.
Browser Studio web assembly (WASM) compiler for client-side zero-server scanning.
π License
MIT License Β© 2026 tonysheesh
Available Tools
3 toolsgenerate_aibomC
Generate an AI Bill of Materials (AIBOM) conforming to AI supply chain governance standards.
Inputs: projectPath (required).
mcp_scanA
Audit an MCP server, codebase, or configuration file against OWASP MCP Top 10 vulnerabilities.
Inputs: path (required).
mcp_verifyB
Cryptographically verify an MCP tool call request signature.
Inputs: signedPayload (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 3 tools
Each tool serves a clearly distinct purpose: mcp_scan audits for vulnerabilities, generate_aibom produces a supply chain document, and mcp_verify checks cryptographic signatures. There is no overlap or ambiguity between these operations.
All tool names use an imperative verb followed by an object (scan, generate, verify), but the prefixes are inconsistent: two use 'mcp_' and one uses 'generate_'. This is a minor deviation from a fully uniform naming pattern.
With exactly 3 tools, the server is tightly scoped to its purpose of MCP security assurance. Each tool covers a distinct, valuable function without bloat or excessive overlap.
The set covers the core security lifecycle: vulnerability scanning, supply chain artifact generation, and request verification. A possible gap is a remediation or compliance-check tool, but for a focused security utility, the surface is quite complete.
Related MCP Connectors
Zero-log MCP server with 49 tools for AI guardrails, secret scanning, MCP linting & EU compliance.
MCP gateway with runtime security policy, tool-call-level control, and audit of agent actions.
MEOK MCP Hardening MCP β automated security red-team for any MCP server. Maps OWASP LLM Top 10
Live behavioral security verifier, schema auditor, and trust oracle for A2A, MCP & x402 agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceThe security runtime for MCP servers. Every tool call inspected. Every attack blocked. Every decision logged.1-
- AlicenseAqualityCmaintenanceSecurity scanning for MCP servers from the inside out. Provides runtime inspection, AST-based static analysis, config audit, dependency analysis, and OWASP MCP Top 10 compliance in a single MCP server.55194 npm6MIT
- AlicenseNot gradedqualityDmaintenanceMCP Shield Runtime is a local-first security gateway that controls MCP tool calls with parameter-level policies, approval gates, secret redaction, rate limiting, contract drift detection, and tamper-evident auditing before they reach the upstream MCP server.2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA modular, security-focused MCP server that exposes enterprise-ready tools for filesystem, database, REST API, system utilities, and AI generation, with authentication, authorization, and audit logging.MIT