dotnet-zap-mcp

Servidor MCP (Model Context Protocol) para OWASP ZAP. Permite a los agentes de IA (Claude, GitHub Copilot, etc.) controlar el escaneo de vulnerabilidades de ZAP mediante MCP.

Características

• 45 herramientas MCP para controlar OWASP ZAP (escaneo, alertas, spider, ajax spider, contexto, autenticación, informes, etc.)

• Gestión integrada de Docker Compose (iniciar/detener ZAP con una sola llamada de herramienta)

• Configuración sin configuración: genera automáticamente claves API y extrae activos de Docker

• Funciona con cualquier cliente compatible con MCP (Claude Desktop, VS Code, etc.)

Related MCP server: Grype MCP Server

Instalación

dotnet tool install -g dotnet-zap-mcp

Requisitos previos

• .NET 10 SDK

• Docker (Docker Engine o Docker Desktop) con soporte de docker compose (para la gestión integrada del contenedor de ZAP)

Configuración

Configuración cero (recomendada)

No se necesita configuración. El agente llama a DockerComposeUp que automáticamente:

1. Extrae los activos de Docker a ~/.zap-mcp/docker/

2. Genera una clave API aleatoria

3. Inicia el contenedor de ZAP en localhost:8090

4. Espera a que ZAP esté en buen estado

Persistencia de datos

El contenedor de ZAP utiliza dos volúmenes Docker con nombre:

En el primer lanzamiento, la plantilla config.xml se copia en zap-home. En lanzamientos posteriores, solo se actualiza la clave API: cualquier cambio realizado a través de ZAP (contextos, ajustes de autenticación, políticas de escaneo, etc.) se conserva.

El volumen zap-data contiene:

• reports/ — informes de escaneo generados

• sessions/ — sesiones de ZAP guardadas

• contexts/ — archivos de contexto exportados

Claude Desktop / Claude Code

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "zap": {
      "command": "zap-mcp"
    }
  }
}

VS Code (Copilot)

Añade a .vscode/mcp.json:

{
  "servers": {
    "zap": {
      "command": "zap-mcp"
    }
  }
}

Con una instancia de ZAP existente

Si ya tienes una instancia de ZAP en ejecución, pasa los detalles de conexión mediante variables de entorno:

{
  "mcpServers": {
    "zap": {
      "command": "zap-mcp",
      "env": {
        "ZAP_BASE_URL": "http://localhost:8090",
        "ZAP_API_KEY": "your-api-key"
      }
    }
  }
}

Herramientas disponibles

Gestión de Docker

Núcleo de ZAP

Spider

Escaneo activo

Escaneo pasivo

Alertas

Informes

Gestión de contexto

Autenticación

Usuarios

Usuario forzado

Ajax Spider

Flujo de trabajo típico

1. El agente llama a DockerComposeUp para iniciar ZAP

2. Configura el navegador/Playwright para usar ZAP como proxy (http://127.0.0.1:8090)

3. Navega por la aplicación objetivo a través del proxy

4. El agente llama a StartSpider para rastrear la aplicación, luego GetSpiderStatus para monitorear el progreso

5. El agente llama a GetPassiveScanStatus para esperar a que se complete el escaneo pasivo

6. El agente llama a StartActiveScan en páginas clave, luego GetActiveScanStatus para monitorear el progreso

7. El agente llama a GetAlertsSummary y GetAlerts para recuperar los hallazgos de vulnerabilidades

8. El agente llama a GetHtmlReport o GetJsonReport para generar un informe de escaneo

9. El agente llama a DockerComposeDown cuando termina

Nota: La configuración de ZAP (contextos, autenticación, políticas de escaneo) se persiste en el volumen Docker zap-home. Puedes detener y reiniciar el contenedor sin perder la configuración.

Pruébalo (con la aplicación vulnerable incluida)

Este repositorio incluye una aplicación web intencionalmente vulnerable para probar el escaneo de ZAP. La aplicación contiene vulnerabilidades comunes (XSS, inyección SQL, CSRF, redirección abierta) para que ZAP pueda detectar hallazgos reales.

Configuración

# Start ZAP and the vulnerable target app
docker compose -f tests/docker/docker-compose.test.yml up -d --build

# Wait until both containers are healthy
docker compose -f tests/docker/docker-compose.test.yml ps

Luego configura tu cliente MCP para conectarse a esta instancia de ZAP:

{
  "mcpServers": {
    "zap": {
      "command": "zap-mcp",
      "env": {
        "ZAP_BASE_URL": "http://localhost:8090",
        "ZAP_API_KEY": "test-api-key-for-ci"
      }
    }
  }
}

La aplicación vulnerable es accesible en http://target desde la red Docker (utilizada por ZAP), y en http://localhost:8080 desde tu máquina host.

Ejemplo 1: Escaneo Rápido

Indicación al agente:

Escanea http://target en busca de vulnerabilidades. Ejecuta un rastreo con spider, espera a que termine el escaneo pasivo, luego muéstrame el resumen de alertas y genera un informe HTML.

Flujo de herramientas esperado:

GetVersion          → Verify ZAP connectivity
StartSpider         → url: "http://target"
GetSpiderStatus     → Poll until 100%
GetPassiveScanStatus → Poll until 0 records remaining
GetAlertsSummary    → baseUrl: "http://target"
GetAlerts           → baseUrl: "http://target"
GetHtmlReport       → Generate report

ZAP descubrirá páginas como /search, /login, /users, /about, /contact, y el escaneo pasivo reportará problemas como cabeceras de seguridad faltantes y vulnerabilidades CSRF.

Ejemplo 2: Escaneo Autenticado

La página /admin requiere inicio de sesión (usuario: admin, contraseña: password). Un escaneo autenticado permite que ZAP acceda a páginas protegidas.

Indicación al agente:

Configura un escaneo autenticado para http://target. El formulario de inicio de sesión está en /login con los campos "username" y "password" (credenciales: admin / password). El indicador de sesión iniciada es "Welcome, admin". Después de configurar la autenticación, rastrea el sitio como el usuario autenticado y ejecuta un escaneo activo.

Flujo de herramientas esperado:

CreateContext                   → contextName: "target-auth"
IncludeInContext                → regex: "http://target.*"
SetAuthenticationMethod         → contextId, authMethodName: "formBasedAuthentication",
                                  authMethodConfigParams: "loginUrl=http://target/login&loginRequestData=username%3D%7B%25username%25%7D%26password%3D%7B%25password%25%7D"
SetLoggedInIndicator            → loggedInIndicatorRegex: "Welcome, admin"
CreateUser                      → contextId, name: "admin"
SetAuthenticationCredentials    → contextId, userId, authCredentialsConfigParams: "username=admin&password=password"
SetUserEnabled                  → contextId, userId, enabled: true
SetForcedUser                   → contextId, userId
SetForcedUserModeEnabled        → enabled: true
StartSpider                     → url: "http://target", contextName: "target-auth"
GetSpiderStatus                 → Poll until 100%
GetPassiveScanStatus            → Poll until 0 records remaining
StartActiveScan                 → url: "http://target"
GetActiveScanStatus             → Poll until 100%
GetAlertsSummary                → baseUrl: "http://target"
GetAlerts                       → baseUrl: "http://target"
SetForcedUserModeEnabled        → enabled: false

Con la autenticación configurada, ZAP puede acceder a /admin y probar vulnerabilidades detrás del inicio de sesión.

Ejemplo 3: Evaluación Completa de Vulnerabilidades

Indicación al agente:

Realiza una evaluación completa de vulnerabilidades de http://target. Rastrea el sitio, ejecuta un escaneo activo y luego dame un desglose detallado de todas las vulnerabilidades descubiertas agrupadas por nivel de riesgo.

Flujo de herramientas esperado:

StartSpider          → url: "http://target", recurse: true
GetSpiderStatus      → Poll until 100%
GetSpiderResults     → Review discovered URLs
GetPassiveScanStatus → Poll until 0 records remaining
StartActiveScan      → url: "http://target", recurse: true
GetActiveScanStatus  → Poll until 100%
GetAlertsSummary     → baseUrl: "http://target"
GetAlerts            → baseUrl: "http://target", riskId: "3" (High)
GetAlerts            → baseUrl: "http://target", riskId: "2" (Medium)
GetAlerts            → baseUrl: "http://target", riskId: "1" (Low)
GetHtmlReport        → Generate final report

El escaneo activo detectará vulnerabilidades que incluyen:

• Alta: SQL Injection (/users?id=), Cross Site Scripting (/search?q=)

• Media: CSRF (tokens faltantes en /login), Open Redirect (/redirect?url=)

• Baja/Informativa: Cabeceras de seguridad faltantes, problemas de cookies, etc.

Limpieza

docker compose -f tests/docker/docker-compose.test.yml down -v

Licencia

MIT