🔴 Servidor MCP Red Team

Un potente servidor MCP de pruebas de penetración que ejecuta 20 herramientas de hacking reales dentro de un contenedor Docker de Kali Linux y las conecta directamente a asistentes de IA como Cursor, Claude o cualquier IDE compatible con MCP.

En lugar de escribir comandos manualmente, simplemente pregunta en lenguaje natural:

"Escanea los puertos en 192.168.1.1" "Encuentra subdominios de example.com" "Comprueba si este sitio tiene inyección SQL"

La IA llama a la herramienta adecuada, la ejecuta en Kali Linux y te da los resultados.

🛠️ Herramientas incluidas (20 en total)

✅ Requisitos

Antes de empezar, asegúrate de tener instalado lo siguiente:

• Git — https://git-scm.com/downloads

• Docker Desktop — https://www.docker.com/products/docker-desktop (habilita los contenedores de Linux)

• Python 3.11 — https://www.python.org/downloads/release/python-3110 (solo necesario localmente si deseas editar el servidor; el contenedor maneja todo lo demás)

• Cualquier IDE compatible con MCP: Cursor, VS Code + Kiro, Claude Desktop, etc.

Nota sobre la versión de Python: El proyecto está escrito para Python 3.11+. El contenedor Docker utiliza el Python 3 (3.12) integrado de Kali. Ambos funcionan correctamente.

🚀 Instalación — Paso a paso

Paso 1 — Clonar el repositorio

git clone https://github.com/YOUR_USERNAME/redteam-mcp.git
cd redteam-mcp

Paso 2 — Construir la imagen de Docker

Esto descarga Kali Linux e instala las 20 herramientas. Tarda entre 10 y 20 minutos la primera vez.

docker build -t redteam-mcp:latest .

Solo necesitas ejecutar esto una vez (o cuando actualices el proyecto).

Paso 3 — Iniciar el contenedor

Windows (PowerShell):

.\run.ps1

Mac / Linux:

bash run.sh

Verifica que se esté ejecutando:

docker ps

Deberías ver redteam-mcp con el estado Up.

Paso 4 — Conectar tu IDE

Abre tu archivo de configuración MCP en tu IDE y pega esto:

{
 "mcpServers": {
 "redteam-kali": {
 "command": "docker",
 "args": [
 "exec", "-i", "redteam-mcp",
 "/app/.venv/bin/python", "/app/src/server.py"
 ],
 "disabled": false,
 "autoApprove": []
 }
 }
}

Dónde pegarlo:

Después de pegar, recarga la ventana de tu IDE (Ctrl+Shift+P → Reload Window).

Paso 5 — Empieza a hacer preguntas

Estás listo. Simplemente escribe en lenguaje natural:

Scan ports on scanme.nmap.org
Find subdomains of tesla.com
Check if http://testphp.vulnweb.com has SQL injection
Detect the WAF on cloudflare.com
Run a nikto scan on http://testphp.vulnweb.com

📋 Guía de uso diario

Iniciar el proyecto

.\run.ps1

Luego recarga la ventana de tu IDE.

Detener al terminar

docker stop redteam-mcp

Reiniciar el contenedor

docker restart redteam-mcp

Restablecimiento completo (si algo falla)

docker rm -f redteam-mcp
.\run.ps1

Reconstruir la imagen (solo después de editar Dockerfile o server.py)

docker rm -f redteam-mcp
docker build -t redteam-mcp:latest .
.\run.ps1

Comprobar los registros del contenedor

docker logs redteam-mcp

Abrir una shell dentro del contenedor

docker exec -it redteam-mcp /bin/bash

⚠️ Aviso legal

Utiliza estas herramientas solo contra sistemas que poseas o para los que tengas permiso explícito por escrito para realizar pruebas. El escaneo no autorizado es ilegal. El objetivo de prueba legal utilizado en los ejemplos es scanme.nmap.org (proporcionado por el proyecto nmap para este propósito).

📁 Estructura del proyecto

redteam-mcp/
├── src/
│ └── server.py # MCP server with all 20 tools
├── Dockerfile # Kali Linux multi-stage build
├── requirements.txt # Python deps (mcp only)
├── run.ps1 # Start container (Windows)
├── run.sh # Start container (Mac/Linux)
└── .kiro/
 └── settings/
 └── mcp.json # IDE MCP config

Resources

• GitHub Repository
Need Help?Related Servers