Herramientas de prueba de penetración MCP Server
Un servidor MCP (Protocolo de contexto de modelo) para herramientas de pruebas de penetración, diseñado para funcionar con varios clientes LLM como Claude Desktop, Roo Code y otros clientes MCP compatibles.
Características
- Herramientas integrales de pruebas de penetración:
- Escaneo de directorios (FFuf, Dirsearch)
- Análisis de vulnerabilidades (Nuclei, XSStrike)
- Pruebas de API
- Reconocimiento
- Y más...
- Listas de palabras preconfiguradas de SecLists
- Generación automatizada de informes
- Integración de Claude Desktop
Prerrequisitos
- Docker y Docker Compose (para configuración en contenedores)
- Aplicación de escritorio Claude u otro cliente compatible con MCP
- Python 3.10+ y uv (para configuración local)
Configuración del directorio
- Cree los directorios necesarios:
# Create directories
mkdir -p reports templates wordlists
- La estructura del directorio debería verse así:
pentest-tools/
├── reports/ # For storing scan reports
├── templates/ # For report templates
├── wordlists/ # For custom wordlists
├── pentest-tools-mcp-server.py
├── config.json
├── requirements.txt
├── docker-compose.yml
└── Dockerfile
Configuración
Configuración de Docker (recomendada)
- Construya e inicie el contenedor:
docker-compose up -d --build
- Verifique que el contenedor esté ejecutándose:
- Verifique los registros si es necesario:
Configuración local
- Instalar dependencias:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
- Instalar las herramientas del sistema necesarias (ejemplo para Ubuntu/Debian):
sudo apt-get install nmap whatweb dnsrecon theharvester ffuf dirsearch sqlmap
Integración de escritorio de Claude
- Configurar Claude Desktop:
Ventanas:
%APPDATA%\Claude\claude_desktop_config.json
MacOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json
- Agregar configuración del servidor:
Para la configuración de Docker:
{
"mcpServers": {
"pentest-tools": {
"command": "docker-compose",
"args": [
"run",
"--rm",
"pentest-tools",
"python3",
"pentest-tools-mcp-server.py"
],
"cwd": "\\Path\\to\\pentest-tools"
}
}
}
Si la configuración anterior no funciona en Windows, pruebe este enfoque alternativo:
{
"mcpServers": {
"pentest-tools": {
"command": "cmd",
"args": [
"/c",
"cd /d \\path\\to\\pentest-tools && docker-compose run --rm pentest-tools python3 pentest-tools-mcp-server.py"
]
}
}
}
Nota sobre cwd (Directorio de trabajo actual):
cwd le dice a Claude Desktop desde qué directorio ejecutar el comando- Debe ser la ruta absoluta al directorio que contiene
docker-compose.yml - En Windows, utilice barras invertidas dobles (
\\ ) en las rutas - En Linux/MacOS, utilice barras diagonales (
/ )
- Reiniciar Claude Desktop
Uso
Comandos disponibles en Claude Desktop:
- Reconocimiento:
- Escaneo de directorios:
/scan example.com --type directory
- Escaneo de vulnerabilidades:
/scan example.com --type full
/scan example.com --type xss
/scan example.com --type sqli
/scan example.com --type ssrf
- Pruebas de API:
/scan api.example.com --type api
Comandos en lenguaje natural:
- "Ejecutar un análisis de seguridad completo en example.com"
- "Comprobar vulnerabilidades XSS en example.com"
- Realizar un reconocimiento en example.com
Detalles de la estructura del directorio
pentest-tools/
├── reports/ # Scan reports directory
│ ├── recon/ # Reconnaissance reports
│ ├── vulns/ # Vulnerability scan reports
│ └── api/ # API testing reports
├── templates/ # Report templates
│ ├── recon.html # Template for recon reports
│ ├── vuln.html # Template for vulnerability reports
│ └── api.html # Template for API test reports
├── wordlists/ # Custom wordlists
│ ├── SecLists/ # Cloned from SecLists repo
│ ├── custom/ # Your custom wordlists
│ └── generated/ # Tool-generated wordlists
├── pentest-tools-mcp-server.py # Main MCP server
├── config.json # Tool configuration
├── requirements.txt # Python dependencies
├── docker-compose.yml # Docker configuration
└── Dockerfile # Container definition
Notas de seguridad
- Asegúrese siempre de tener permiso para escanear objetivos
- Mantenga las herramientas y dependencias actualizadas
- Revise cuidadosamente los resultados del escaneo
- Seguir prácticas de divulgación responsable