Descripción general

MCPwner es un servidor del Protocolo de Contexto del Modelo (MCP) que integra herramientas de pruebas de seguridad en flujos de trabajo impulsados por LLM. Proporciona una interfaz unificada para escaneo de secretos, análisis estático (SAST), análisis de composición de software (SCA), seguridad de infraestructura como código (IaC), fuzzing de código fuente, reconocimiento, pruebas dinámicas de seguridad de aplicaciones (DAST) e investigación de vulnerabilidades, incluido el descubrimiento de 0-day. En lugar de encadenar herramientas manualmente y pegar salidas en su LLM, MCPwner estandariza y transmite los resultados directamente al contexto de trabajo del modelo. Esto permite un razonamiento continuo, correlación y descubrimiento de rutas de ataque a lo largo del ciclo de vida de la investigación de seguridad, desde el mapeo de superficies de ataque y la identificación de vulnerabilidades conocidas hasta el descubrimiento de vectores de ataque novedosos.

Nota: Este proyecto está en desarrollo activo. Obtenga más información sobre los MCP aquí.

Herramientas integradas

Herramientas futuras

Las siguientes herramientas están planificadas para versiones futuras.

Deserialización insegura

Generadores de cadenas de gadgets y payloads para weaponizar sumideros de deserialización identificados durante SAST. Existen ecosistemas maduros de cadenas de gadgets para Java, .NET y PHP; Python está cubierto mediante generación de pickle malicioso (la deserialización de Ruby/Node está basada en payloads y reside en el corpus de Payloads a continuación):

• ysoserial - Java
• ysoserial.net - .NET
• PHPGGC - PHP
• marshalsec - Marshalls/unmarshalls JVM
• Fickling - Python (pickle)

Contrabando de solicitudes HTTP

• smuggler - Contrabando/desincronización de solicitudes HTTP/1.1 (CL.TE, TE.CL, TE.TE)
• h2csmuggler - Contrabando de actualización h2c (texto claro HTTP/2) (distinto de desincronización HTTP/2)
• http2smugl - Contrabando/desincronización de solicitudes HTTP/2

Payloads

Corpus curados de payloads y listas de palabras para respaldar las herramientas anteriores:

• SecLists - Agregado de payloads de fuzzing, credenciales y listas de inyección
• PayloadsAllTheThings - Payloads de ataque y bypasses organizados por clase de vulnerabilidad
• FuzzDB - Primitivos de inyección de fallos y patrones de recursos predecibles

Ejemplos de uso

Canalización de enumeración automatizada```

"Enumerate and scan example.com" → MCPwner chains: Subfinder + Amass → Masscan + Nmap → httpx → Katana + gau → ffuf + Arjun

Auditoría de Seguridad```

"Run a security audit on my Python project" → MCPwner runs Bandit (SAST), OSV-Scanner (SCA), and secrets scanning

Explotación de Objetivos en Vivo```

"Test for SQLi and XSS on http://localhost:8080" → MCPwner chains: sqlmap + Dalfox and verifies findings

2. Configura el servidor: ```bash cp config/config.yaml.example config/config.yaml

   Edit config/config.yaml as needed

   root@kitploit:~

3. Iniciar los servicios: ```bash docker-compose up -d --build
   root@kitploit:~

4. Verificar que los servicios estén en ejecución: ```bash docker-compose ps
   root@kitploit:~

Conecta tu IDE

Una vez que los contenedores Docker estén en ejecución, agrega MCPwner a tu cliente MCP:

Importante: Registro Dinámico de Herramientas MCPwner utiliza una arquitectura modular con opción de participación. Las herramientas de seguridad se rigen por los profiles de Docker Compose.

1. El archivo .env (COMPOSE_PROFILES=sast,secrets,reconnaissance,dast,etc) determina qué contenedores se ponen en línea. Alternativamente, puedes sobrescribir esto e iniciar perfiles específicos a través de la CLI: docker compose --profile sast --profile dast up -d.
2. El servidor MCP sondea dinámicamente los contenedores en ejecución al inicio y registra solo las herramientas saludables con tu LLM.
3. Si deseas omitir herramientas específicas (por ejemplo, semgrep), omite su categoría (sast) del archivo .env y lista manualmente las otras herramientas que desees (bandit,gosec,codeql).
4. Nota: Las herramientas de la categoría utilities (por ejemplo, Linguist, WireMock, Chromium) se tratan como dependencias centrales permanentes. Se ejecutan incondicionalmente con docker compose up -d para garantizar que las dependencias críticas entre herramientas (como la detección de idiomas) siempre funcionen.

Ubicaciones de los Archivos de Configuración:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Cursor/Kiro: mcp.json en tu proyecto o directorio de configuración

Instalación con un Solo Clic (requiere Docker en ejecución):

Configuración Manual:

Agrega lo siguiente a tu archivo de configuración MCP:```json { "mcpServers": { "mcpwner": { "command": "docker", "args": ["exec", "-i", "mcpwner-server", "python", "src/server.py"], "env": {} } } }

Luego usa la herramienta create_workspace con:

• source_type="local"
• source="/mnt/projects/my-project"

Persistencia de Datos

MCPwner persiste automáticamente los metadatos del espacio de trabajo y de la base de datos de CodeQL en los reinicios del contenedor mediante almacenamiento basado en archivos en el volumen compartido de Docker (/workspaces/.metadata/). No se requiere configuración: el sistema carga los datos existentes al iniciar y los guarda después de cada operación mediante escrituras atómicas para evitar la corrupción.

Control de Limpieza del Espacio de Trabajo:

• delete_files=True, delete_metadata=False - Libera espacio en disco pero conserva el historial del espacio de trabajo (recomendado)
• delete_files=True, delete_metadata=True - Eliminación completa del espacio de trabajo y metadatos
• delete_files=False, delete_metadata=True - Elimina de la lista pero conserva los archivos en disco

Copia de seguridad:```bash

Backup entire workspaces volume

docker run --rm -v mcpwner_workspaces:/data -v $(pwd):/backup
alpine tar czf /backup/workspaces-backup.tar.gz /data

Restore volume

docker run --rm -v mcpwner_workspaces:/data -v $(pwd):/backup
alpine tar xzf /backup/workspaces-backup.tar.gz -C /

Herramientas MCP Disponibles

MCPwner expone las siguientes herramientas a través de la interfaz MCP:

Gestión del Espacio de Trabajo:

• create_workspace - Inicializar espacio de trabajo de escaneo desde una ruta local, URL de Git o repositorio de GitHub
• list_workspaces - Listar todos los espacios de trabajo disponibles
• cleanup_workspace - Eliminar espacio de trabajo y datos asociados

Registro de Hallazgos:

Con alcance al espacio de trabajo, persistido en disco (<workspace>/findings/<id>.json), y siempre disponible — no se requiere contenedor ni verificación de estado. Esta es la fuente de verdad para el pipeline de investigación profunda multi-agente: cada hipótesis, resultado de PoC y veredicto de revisión es una entrada de hallazgo en lugar de prosa.

• upsert_finding - Crear o actualizar un hallazgo. Fusiona en profundidad con una entrada existente por defecto, por lo que un agente puede escribir su propio subobjeto (ej. poc) sin sobrescribir los campos de otro agente (ej. review)
• list_findings - Listar todos los hallazgos en un espacio de trabajo, opcionalmente filtrados por status (ej. poc-confirmed, review-approved)
• get_finding - Recuperar un único hallazgo por id

SAST (Análisis Estático):

• run_sast_scan - Ejecutar herramientas de análisis estático (Semgrep, Bandit, Gosec, Brakeman, PMD, Psalm, NodeJsScan, Joern, YASA)
• get_sast_report - Recuperar resultados del escaneo SAST
• sast_list_tools - Listar herramientas SAST disponibles

Detección de Secretos:

• run_secrets_scan - Ejecutar herramientas de escaneo de secretos (Gitleaks, TruffleHog, Whispers, detect-secrets, Hawk-Eye)
• get_secrets_report - Recuperar resultados del escaneo de secretos
• secrets_list_tools - Listar herramientas de escaneo de secretos disponibles

SCA (Análisis de Composición de Software):

• run_sca_scan - Analizar dependencias en busca de vulnerabilidades (Grype, Syft, OSV-Scanner, Retire.js)
• get_sca_report - Recuperar resultados del escaneo SCA
• sca_list_tools - Listar herramientas SCA disponibles

Reconocimiento:

• run_reconnaissance_scan - Ejecutar una única herramienta de reconocimiento (Subfinder, Amass, Nmap, Masscan, httpx, Katana, ffuf, bbot, gau, Arjun, wafw00f, Kiterunner)
• run_reconnaissance_chain - Encadenar múltiples herramientas de reconocimiento secuencialmente
• get_reconnaissance_report - Recuperar resultados del escaneo de reconocimiento
• reconnaissance_list_tools - Listar herramientas de reconocimiento disponibles

CodeQL:

• detect_languages - Detectar lenguajes en el código base mediante Linguist
• create_codeql_database - Crear base de datos CodeQL para análisis
• list_databases - Listar bases de datos CodeQL disponibles
• list_query_packs - Listar paquetes de consultas disponibles
• execute_query - Ejecutar consultas CodeQL específicas

Seguridad de Infraestructura e IaC:

• run_iac_scan - Escanear infraestructura como código en busca de configuraciones incorrectas (Checkov, KICS, Terrascan, TFSec, Hadolint)
• get_iac_report - Recuperar resultados del escaneo IaC
• iac_list_tools - Listar herramientas de escaneo IaC disponibles

Fuzzing de Código Fuente:

• run_fuzzing_scan - Ejecutar una campaña de fuzzing de caja blanca guiada por cobertura contra un harness por objetivo (Atheris, Jazzer, Jazzer.js, PHP-Fuzzer)
• get_fuzzing_report - Recuperar resultados de fallos de fuzzing (entrada que causa el fallo + traza de pila)
• fuzzing_list_tools - Listar motores de fuzzing disponibles, filtrados por lenguaje detectado

DAST (Pruebas Dinámicas de Seguridad de Aplicaciones):

• run_dast_scan - Ejecutar herramientas de pruebas dinámicas de seguridad de aplicaciones (sqlmap, NoSQLMap, Commix, Dalfox, SSTImap, SSRFmap, jwt_tool, interactsh)
• get_dast_report - Recuperar resultados del escaneo DAST
• dast_list_tools - Listar herramientas DAST disponibles

Utilidades:

• run_utilities_scan - Ejecutar una herramienta de utilidad contra un objetivo en vivo (Linguist, WireMock, Mitmproxy, aiohttp, Headless Chromium)
• get_utilities_report - Recuperar resultados del escaneo de utilidades
• utilities_list_tools - Listar herramientas de utilidad disponibles y sus opciones de configuración

Salud y Monitoreo:

• health_check - Verificar disponibilidad del servidor y las herramientas
• list_tools - Listar todas las herramientas disponibles y su estado

Consideraciones de Seguridad

MCPwner ejecuta herramientas de seguridad que pueden realizar operaciones intrusivas. Úselo solo en sistemas y bases de código de su propiedad o para los que tenga permiso explícito para realizar pruebas; el acceso no autorizado es ilegal. Restrinja el acceso al servidor MCP a usuarios autorizados y considere el aislamiento de la red para implementaciones en producción. Revise las configuraciones de las herramientas antes de ejecutar escaneos, ya que algunas herramientas pueden generar tráfico de red significativo o carga del sistema. Registre la ejecución y los resultados de las herramientas, teniendo en cuenta que los escaneos de seguridad pueden activar alertas en los sistemas de monitoreo. Siga prácticas de divulgación responsable al informar vulnerabilidades descubiertas con MCPwner. Mantenga las imágenes Docker actualizadas y escanee los contenedores en busca de vulnerabilidades regularmente. Nunca confíe claves de API, tokens o credenciales a archivos de configuración; use variables de entorno o sistemas de gestión de secretos en su lugar.

Además, usted debe ser responsable de su propia seguridad al ejecutar estas herramientas y acceder a bibliotecas de terceros; se sugiere ejecutar todo en un entorno aislado y sin autenticación especial (minimizado y endurecido cuando sea factible).