Audita servidores Model Context Protocol basándose en el OWASP MCP Top 10 para identificar vulnerabilidades de seguridad y asignar calificaciones de seguridad.
También conocido como CodingSelim/mcp-scan, owasp-mcp-scan
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.2.1
- Último commit
- 10 oct 2026
- Licencia
- MIT
¿Qué es scan MCP?
scan es un MCP server. Audita servidores Model Context Protocol basándose en el OWASP MCP Top 10 para identificar vulnerabilidades de seguridad y asignar calificaciones de seguridad.
Resumen generado a partir del README del proyecto
Acerca del MCP server de scan
La función principal de mcp-scan es auditar servidores Model Context Protocol en busca de vulnerabilidades de seguridad. Esta herramienta evalúa servidores en vivo frente al OWASP MCP Top 10 para identificar riesgos como inyección de comandos, path traversal y exposición de secretos. Asigna una calificación de seguridad de la A a la F según sus hallazgos, ayudando a los desarrolladores a verificar la seguridad de un servidor antes de integrarlo en sus flujos de trabajo.
Los usuarios pueden ejecutar el escáner a través de una interfaz de línea de comandos usando npx, apuntando a servidores locales vía stdio o endpoints remotos mediante HTTP. Está diseñado para ser pasivo y de solo lectura, lo que significa que analiza las capacidades anunciadas sin llegar a invocar herramientas ni enviar exploits, por lo que es seguro para entornos de producción. El escáner proporciona resultados en formatos de consola, JSON o SARIF para su integración en pipelines de CI/CD.
Más allá de las comprobaciones de herramientas individuales, el escáner utiliza un análisis especializado de toxic-flow para detectar la trifecta letal de leer datos privados, ingerir contenido no confiable y exfiltrar información. También puede instalarse como un MCP server, lo que permite que clientes de IA como Claude Desktop, Cursor o Windsurf realicen auditorías de seguridad bajo demanda utilizando la herramienta scan_mcp_server.
Qué puedes hacer con él
- 1Auditar un servidor localUn desarrollador puede realizar un control de seguridad en un MCP server de sistema de archivos local antes de conectarlo a un agente.
- 2Automatizar la seguridad en CI/CDLos equipos pueden bloquear sus pipelines de despliegue si un servidor recibe una calificación de seguridad de alto riesgo.
- 3Detectar exfiltración de datos complejaLos investigadores de seguridad pueden identificar servidores que combinan capacidades de lectura de datos y exfiltración mediante la comprobación de toxic-flow.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar scan MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar scan MCP en Claude Code
$ claude mcp add mcp-scan -- npx -y owasp-mcp-scanInstalar scan MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Instalar scan MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp-scan": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Instalar scan MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp-scan","type":"stdio","command":"npx","args":["-y","owasp-mcp-scan"]}'Instalar scan MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Instalar scan MCP en Codex
$ codex mcp add mcp-scan -- npx -y owasp-mcp-scanInstalar scan MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-scan] command = "npx" args = ["-y", "owasp-mcp-scan"]
Instalar scan MCP en Gemini CLI
$ gemini mcp add -s user mcp-scan npx -- -y owasp-mcp-scanInstalar scan MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-scan": {
"command": "npx",
"args": [
"-y",
"owasp-mcp-scan"
]
}
}
}Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblecodingselim/mcp-scan is public and reachablegithub.com/codingselim/mcp-scan ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-10github.com/codingselim/mcp-scan ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from owasp-mcp-scanAprobado
- No hay avisos críticos en el paquete ni en sus dependencias100 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHub🛡️ mcp-scan
Passive security scanner for Model Context Protocol servers. Point it at any running MCP server; it audits the live server against the OWASP MCP Top 10 and grades it A–F. Read-only, so it is safe to run against production.
npx owasp-mcp-scan --stdio "npx -y @modelcontextprotocol/server-filesystem /tmp"
I ran it against the 12 most-installed MCP servers. 9 of them failed. No install, no config, no exploiting anything.
Why
MCP tool descriptions are fed straight into your model's context, and most public servers were never security-reviewed. A bad one can hide instructions in a description, expose a raw-shell tool, or leak a key; and your agent acts on it. Endor Labs found 82% of servers prone to path traversal, 34% to command injection.
mcp-scan is the gut-check before you wire a server in. It's passive: it reads advertised capabilities and analyzes them statically, never invoking tools, so it's safe against production servers.
How it works
- Connects to the server over stdio or Streamable HTTP and enumerates every advertised tool, prompt, and resource.
- Runs 12 static checks across that surface: secrets, injection, SSRF, path traversal, tool poisoning, excessive scope, and more.
toxic-flowreasons across the whole toolset for the lethal trifecta (reads private data + ingests untrusted content + can exfiltrate), the shape single-tool scanners miss.- Scores 0-100 and grades A-F (any critical forces F). Emits console, JSON, or SARIF.
It never calls a tool, never fuzzes, and never sends an exploit. The worst it does is read what the server already tells everyone.
Real findings on real servers
12 popular npm servers, actual output (snapshot 2026-07-11, full benchmark):
| Server | Tools | Grade | 🔴 | 🟠 | 🟡 | Notable |
|---|---|---|---|---|---|---|
firecrawl-mcp |
26 | F | 2 | 11 | 1 | lethal trifecta (MCP10) + code exec (MCP05) |
@modelcontextprotocol/server-filesystem |
14 | F | 0 | 1 | 11 | unconstrained path params (MCP01) |
@modelcontextprotocol/server-puppeteer |
7 | F | 1 | 2 | 0 | script param executes JS (MCP05) |
tavily-mcp |
5 | F | 0 | 3 | 1 | untrusted-input + exfiltration (MCP10) |
@modelcontextprotocol/server-memory |
9 | F | 0 | 3 | 0 | delete_* tools, no confirmation (MCP02) |
@modelcontextprotocol/server-github |
26 | D | 0 | 0 | 2 | state-changing tools (MCP02) |
@modelcontextprotocol/server-slack |
8 | C | 0 | 1 | 0 | reads + posts = data + exfil (MCP10) |
@modelcontextprotocol/server-everything |
13 | A | 0 | 0 | 0 | clean ✓ |
@kazuph/mcp-fetch |
1 | A | 0 | 0 | 0 | clean ✓ |
9 of 12 flagged, 3 clean, every row audited finding-by-finding, false positives stripped rather than padded. Reproduce any row yourself:
npx owasp-mcp-scan --stdio "npx -y firecrawl-mcp" # F: lethal trifecta + code exec
npx owasp-mcp-scan --stdio "npx -y @modelcontextprotocol/server-everything" # A: clean
Use it
CLI
npx owasp-mcp-scan --stdio "<command>" # local stdio server
npx owasp-mcp-scan --url https://host/mcp --header "Authorization: Bearer $TOKEN"
npx owasp-mcp-scan --config ~/.cursor/mcp.json --format sarif --output mcp.sarif
As an MCP server, let your agent scan servers on demand ("scan this MCP server before I add it"). Add to any client; this mcpServers shape works in Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, and Gemini CLI:
{ "mcpServers": { "mcp-scan": { "command": "npx", "args": ["-y", "owasp-mcp-scan", "--serve"] } } }
OpenAI Codex (~/.codex/config.toml):
[mcp_servers.mcp-scan]
command = "npx"
args = ["-y", "owasp-mcp-scan", "--serve"]
Exposes two tools: scan_mcp_server (audit a stdio/HTTP target) and list_checks.
Claude Code plugin
/plugin marketplace add CodingSelim/mcp-scan
/plugin install mcp-scan@mcp-scan
Also on the official MCP registry as io.github.CodingSelim/mcp-scan. Publishing steps: PUBLISHING.md.
What it checks
Full OWASP MCP Top 10 (2025) coverage, 12 checks:
| Check | OWASP | Catches |
|---|---|---|
secret-exposure |
MCP01 | AWS / OpenAI / Anthropic / GitHub / GitLab / Stripe / SendGrid / npm / HF / DB URIs / JWT / private keys in advertised text |
transport |
MCP01 | Plaintext http:// to a non-loopback host |
path-traversal |
MCP01 | file:///{path} templates and unconstrained path params |
excessive-scope |
MCP02 | Destructive tools (delete, drop, transfer) with no confirmation |
tool-poisoning |
MCP03 | Instruction overrides, hidden exfiltration directives, zero-width / Unicode-tag smuggling |
tool-shadowing |
MCP03 / MCP09 | Duplicate tool-name collisions and "call me first" precedence injection |
supply-chain |
MCP04 / MCP09 | Unpinned/placeholder versions and homoglyph server names |
command-injection |
MCP05 | Unconstrained command / shell / code params, raw SQL, advertised execution |
ssrf |
MCP05 | Arbitrary url / host params with no allowlist |
tool-poisoning (dynamic) |
MCP06 | Injection in resource contents and server instructions |
authn |
MCP07 | HTTP servers that complete an unauthenticated handshake |
telemetry |
MCP08 | High-impact tools with no audit trail (advisory, unscored) |
toxic-flow |
MCP10 | Lethal trifecta: one server that reads private data, ingests untrusted content, and can exfiltrate |
toxic-flow is the standout, it reasons across the whole toolset, catching the GitHub-MCP / email-agent injection shape that per-tool checks miss.
Output & CI
console (default) · json · sarif (GitHub Code Scanning). Exit code is non-zero at/above --fail-on (default high), so it gates CI:
- run: npx owasp-mcp-scan --url ${{ secrets.MCP_URL }} --format sarif --output mcp.sarif
- uses: github/codeql-action/upload-sarif@v3
with: { sarif_file: mcp.sarif }
Limitations (read these)
- Static analysis can't see runtime sandboxing, a server that safely confines paths still flags them. Verify against actual enforcement.
- Auth and transport checks apply to HTTP targets only.
- Heuristics favor recall, so triage findings in context. When a rule is tightened to kill a false positive, a test pins the intended behavior.
- Scanning a stdio target spawns that command, so run it only on servers you trust.
Develop
npm install && npm run build && npm test # 48 tests, incl. live end-to-end fixture scans
Checks are pure and isolated (src/checks/), reusing detectors in src/detectors/. See CONTRIBUTING.md.
References
OWASP MCP Top 10 · MCP Security Cheat Sheet · Vulnerable MCP Project · MCPTox
MIT © CodingSelim
Preguntas sobre scan MCP
¿Cómo agrego scan MCP a Claude Code?
Ejecuta claude mcp add mcp-scan -- npx -y owasp-mcp-scan en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego scan MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Es seguro ejecutarlo en servidores de producción?
Sí, es un escáner pasivo de solo lectura que analiza las capacidades anunciadas sin invocar herramientas.
¿Qué es lo que comprueba el escáner?
Realiza 12 comprobaciones estáticas que incluyen exposición de secretos, inyección, SSRF, path traversal y la trifecta 'toxic-flow'.