SecOps MCP Server

Servidor MCP (Model Context Protocol) con herramientas de seguridad Dockerizadas para integración con n8n y otros clientes MCP.

🚀 Características

• FastMCP 2.0 con HTTP Streamable

• 14 herramientas de seguridad Dockerizadas

• API Key estable para integración permanente

• Compatible con n8n y otros clientes MCP

• Listo para VPS con configuración automática

Related MCP server: Pentest Tools MCP Server

🛠️ Herramientas Disponibles

1. nuclei_scan_wrapper - Escaneo de seguridad con Nuclei

2. nmap_scan_wrapper - Escaneo de puertos con Nmap

3. ffuf_scan_wrapper - Fuzzing de directorios con FFUF

4. dirsearch_scan_wrapper - Búsqueda de directorios con Dirsearch

5. subfinder_scan_wrapper - Enumeración de subdominios con Subfinder

6. amass_scan_wrapper - Enumeración de subdominios con Amass

7. tlsx_scan_wrapper - Escaneo TLS con TLSX

8. wp_scan_wrapper - Escaneo de WordPress con WPScan

9. hashcat_wrapper - Cracking de hashes con Hashcat

10. sqlmap_wrapper - Inyección SQL con SQLMap

11. xsstrike_wrapper - Detección de XSS con XSStrike

12. wfuzz_wrapper - Fuzzing web con WFuzz

13. get_tools_status - Estado de todas las herramientas

14. ping_tool - Verificar disponibilidad de herramienta específica

📋 Instalación Local

Prerrequisitos

• Python 3.8+

• Docker

• Git

Pasos

1. Clonar el repositorio:

git clone <repository-url>
cd secops-mcp

2. Configurar variables de entorno:

cp security.env.example .env
# Editar .env con tus configuraciones

3. Crear entorno virtual:

python3 -m venv secops-env
source secops-env/bin/activate

4. Instalar dependencias:

pip install -r requirements.txt

5. Configurar herramientas Docker:

./scripts/setup-docker-tools.sh

6. Iniciar servidor:

source secops-env/bin/activate
fastmcp run main.py --transport http --host 0.0.0.0 --port 8080

🚀 Despliegue en VPS

Automático (Recomendado)

./deploy_vps.sh

Manual

1. Subir archivos al VPS

2. Ejecutar ./scripts/setup-docker-tools.sh

3. Configurar .env

4. Crear entorno virtual e instalar dependencias

5. Configurar firewall (puerto 8080)

6. Iniciar servidor

🔧 Configuración para n8n

Flujo MCP Completo

El servidor usa el protocolo MCP estándar con HTTP Streamable:

1. GET /mcp - Obtener session ID

2. POST /mcp - Initialize

3. POST /mcp - Notifications/Initialized

4. POST /mcp - Tools/List

5. POST /mcp - Tools/Call

Configuración de Nodos HTTP Request en n8n

Ver n8n_mcp_reference.py para la configuración completa de cada nodo.

Documentación Técnica

Ver MCP_FLOW_DOCUMENTATION.md para detalles técnicos del protocolo.

🧪 Pruebas

Script de Prueba Final

python test_final_working_mcp.py

Referencia para n8n

python n8n_mcp_reference.py

📁 Estructura del Proyecto

secops-mcp/
├── main.py                          # Servidor MCP principal
├── deploy_vps.sh                    # Script de despliegue automático
├── test_final_working_mcp.py        # Script de prueba completo
├── n8n_mcp_reference.py             # Referencia para n8n
├── MCP_FLOW_DOCUMENTATION.md        # Documentación técnica
├── security.env.example             # Variables de entorno
├── requirements.txt                 # Dependencias Python
├── scripts/
│   ├── setup-docker-tools.sh        # Configurar herramientas Docker
│   ├── setup-python-env.sh          # Configurar entorno Python
│   ├── start-with-venv.sh           # Iniciar con entorno virtual
│   └── test-docker-tools.sh         # Probar herramientas Docker
├── tools/                           # Herramientas de seguridad
└── data/                            # Datos y configuraciones

🔑 Configuración de Seguridad

Variables de Entorno (.env)

# API Key estable (NO EXPIRA)
MCP_API_KEY=secops-mcp-stable-key-2024

# IPs permitidas (opcional)
MCP_ALLOWED_IPS=127.0.0.1,localhost

# Rate limiting
MCP_RATE_LIMIT=true

# Configuración del servidor
MCP_PORT=8080
MCP_HOST=0.0.0.0

🌐 URLs del Servidor

• Local: http://localhost:8080/mcp

• VPS: http://TU_IP_VPS:8080/mcp

📚 Documentación Adicional

• Flujo MCP: MCP_FLOW_DOCUMENTATION.md

• Referencia n8n: n8n_mcp_reference.py

• Instrucciones VPS: VPS_INSTRUCTIONS.md

✅ Estado Actual

• ✅ Servidor MCP funcionando con FastMCP 2.0

• ✅ 14 herramientas disponibles y ejecutándose

• ✅ Flujo MCP completo probado y documentado

• ✅ Compatible con n8n con configuración detallada

• ✅ Listo para VPS con script de despliegue automático

• ✅ HTTP Streamable funcionando correctamente

🆘 Soporte

Si encuentras problemas:

1. Verificar que Docker esté ejecutándose

2. Comprobar que el puerto 8080 esté abierto

3. Revisar los logs del servidor

4. Ejecutar python test_final_working_mcp.py para diagnóstico

📄 Licencia

Ver LICENSE para detalles de la licencia.