🐕‍🔥 Xolotl

Un guardián que baja al inframundo de tu código.

Servidor MCP + plugin de Claude Code que une siete escáneres de seguridad open source en una sola herramienta y pone a un agente de IA a hacer lo que los escáneres no hacen: leer el código, descartar falsos positivos con criterio, priorizar y verificar que cada arreglo funcione.

SAST · SCA · Secretos · Contenedores · IaC · DAST · Triage con IA

En la mitología mexica, Xolotl es el dios con forma de perro que guía y protege a las almas en su viaje por el Mictlán, el inframundo. Esta herramienta hace ese viaje por las capas que nadie mira: el historial de git, las dependencias transitivas, los Dockerfiles y las rutas de la API.

Qué hace

Los resultados de todas las herramientas se normalizan a un mismo formato y se deduplican: si Trivy y OSV reportan la misma CVE, o Gitleaks y Trivy el mismo secreto, queda un solo hallazgo con ambas fuentes.

Related MCP server: MCPAmpel

Qué tiene de nuevo

Los escáneres de seguridad existen hace años. El problema nunca fue encontrar hallazgos: es que un reporte de 300 líneas, la mitad falsos positivos, termina ignorado. Xolotl cambia el modelo de uso en cinco puntos:

1. El agente cierra el ciclo completo. Escanear → leer el código de cada hallazgo → decidir si es explotable → parchear → re-escanear → comparar corridas. Lo que antes eran cinco herramientas y una tarde de un analista, pasa en una conversación.

2. El triage tiene memoria. Cada decisión (false_positive, accepted_risk, fixed) se guarda con su justificación y una huella estable del hallazgo. El siguiente escaneo ya llega filtrado, y si algo marcado como corregido reaparece, se reabre solo como regresión.

3. Los límites de seguridad están en el servidor, no en el prompt. El DAST solo corre contra objetivos registrados con quién autorizó y con qué evidencia. Los secretos se guardan redactados. Ningún proceso se lanza con shell. Ningún binario se instala si su SHA-256 no coincide. Un agente confundido no puede saltarse estas reglas.

4. Verificación de parches por diferencia. runs_diff responde lo que importa en una revisión: qué se resolvió, qué es nuevo y qué persiste. Un arreglo que solo esquiva la regla, o que introduce otro problema, se ve de inmediato.

5. Cero infraestructura. Sin Docker, sin servidor, sin cuentas. xolotl_install baja los binarios oficiales a una carpeta propia. Funciona igual en Claude Code, Claude Desktop o cualquier cliente MCP.

Alcances

Cubre

• Código fuente en cualquier lenguaje que soporte Semgrep (30+), con análisis profundo de flujo de datos en los lenguajes de CodeQL (JS/TS, Python, Java, C#, Go, Ruby, C/C++, Swift, Rust, GitHub Actions).

• Dependencias de npm, pip/poetry/uv, Maven/Gradle, Go, Cargo, Composer, NuGet, RubyGems y más (todo lo que leen OSV-Scanner y Trivy).

• Historial completo de git para secretos.

• Imágenes de contenedor desde un registro, el daemon local o un .tar.

• Aplicaciones y servicios en ejecución con las plantillas de la comunidad de Nuclei (miles de CVE, paneles expuestos, malas configuraciones, TLS).

• Informes en Markdown, HTML autocontenido, SARIF 2.1.0 (GitHub/GitLab code scanning, VS Code) y JSON.

No cubre (y no pretende)

• Lógica de negocio y control de acceso: IDOR, permisos mal aplicados, flujos de pago. Ningún escáner por patrones los encuentra bien. El agente puede revisarlos a mano siguiendo las rutas de la API, pero eso es revisión manual asistida, no detección automática.

• Pruebas de penetración completas: Nuclei detecta lo conocido por plantillas; no reemplaza a un pentester.

• Seguridad en tiempo de ejecución: no monitorea producción.

• Semgrep Assistant (la IA de Semgrep) es comercial y no está incluida; ese papel lo cumple el agente.

Formas de usarlo

Instalación

Requiere Node.js 20+. Opcional: uv para instalar o ejecutar Semgrep y Bandit al vuelo.

git clone https://github.com/Ricardoarangob26/xolotl.git
cd xolotl
npm install && npm run build

Como plugin de Claude Code (MCP + skills)

claude plugin marketplace add ./xolotl
claude plugin install xolotl@xolotl

Solo el servidor MCP (Claude Code, Claude Desktop, otro cliente)

claude mcp add xolotl --scope user -- node /ruta/a/xolotl/dist/index.js

{ "mcpServers": { "xolotl": { "command": "node", "args": ["/ruta/a/xolotl/dist/index.js"] } } }

Luego, en el chat:

revisa qué escáneres faltan e instálalos

audita la seguridad de /ruta/al/proyecto

Herramientas del MCP

Prompts MCP: triage_run, fix_finding, review_patch. Skills: appsec-audit, appsec-triage, appsec-dast, appsec-fix.

Modelo de seguridad de la propia herramienta

• Procesos sin shell, con argumentos en arreglo: nada de inyección por comillas en rutas o parámetros.

• Gitleaks corre con --redact; Trivy enmascara; las cabeceras de autenticación del DAST se redactan antes de guardar.

• DAST solo contra localhost y los objetivos de scope.json. Se rechazan alcances como *, comodines de TLD o rangos mayores a /16. Plantillas intrusivas (dos, fuzz, fuerza bruta, default-login, rce) y detección fuera de banda (interactsh) desactivadas salvo que se pidan explícitamente.

• Instalación solo desde releases oficiales; si el SHA-256 publicado no coincide, se aborta.

• Descartar un hallazgo exige una justificación escrita.

Herramientas que lo complementan

Todas open source. Varias encajan como un escáner más (cualquier herramienta con salida SARIF ya se puede leer con parseSarif).

Datos y configuración

Todo vive en ~/.xolotl (cámbialo con XOLOTL_HOME):

~/.xolotl/
├── tools/        binarios gestionados (tienen prioridad sobre los del PATH)
├── runs/<id>/    salida cruda de cada escáner, findings.json, meta.json e informes
├── scope.json    alcance DAST autorizado
└── triage.json   decisiones de triage por huella

GITHUB_TOKEN (opcional) evita el límite de la API de GitHub al instalar escáneres.

Desarrollo

npm run build                          # typecheck + bundle en dist/index.js (sin dependencias en tiempo de ejecución)
node scripts/selftest.mjs              # levanta el MCP y escanea un proyecto vulnerable generado al vuelo
node scripts/selftest.mjs --install    # instala antes los escáneres que falten
node scripts/call.mjs scan_static '{"path":"/ruta"}'   # llama cualquier tool desde la terminal

Estructura: src/scanners.ts lanza cada herramienta, src/parsers.ts traduce su salida al formato común, src/findings.ts normaliza y deduplica, src/store.ts guarda corridas y triage, src/scope.ts aplica el alcance DAST, src/report.ts genera los informes. Agregar un escáner es una función en cada uno de los dos primeros.

Probado en Windows 11 con Semgrep 1.181, Bandit 1.9, OSV-Scanner 2.7, Trivy 0.76, Gitleaks 8.30 y Nuclei 3.11. Linux y macOS están contemplados (instalador y rutas), pero aún sin probar. CodeQL está integrado pero todavía no se ha probado de punta a punta.

Licencia

MIT