mcp-centinela-web

MCP Server para automatizar flujos web con Chrome/Playwright.

Lee una historia de Jira, inspecciona la página de inicio, genera un test Playwright orientado al flujo y lo ejecuta en un navegador headless, produciendo trazas, screenshots y reportes.

Qué hace

• Lee historias de Jira y extrae criterios relevantes.
• Abre páginas web en Chrome headless para inspeccionar el flujo.
• Genera y ejecuta tests Playwright enfocados en el flujo funcional.
• Produce evidencias: trazas, screenshots y reportes.
• Genera un SUMMARY.md por ejecución con links a todas las evidencias.
• Sirve las evidencias por HTTP en http://127.0.0.1:4731/<runId>/ para abrirlas en el navegador.
• Si no se indica la URL del ambiente (ni BASE_URL en .env), las tools la preguntan al usuario.

Instalación

No requiere instalación manual. Copia mcp-config.example.json a tu configuración de MCP (Windsurf, Cursor, Cline, etc.) y reemplaza el token:

{
  "mcpServers": {
    "centinela-web": {
      "command": "npx",
      "args": ["-y", "mcp-centinela-web"],
      "env": {
        "JIRA_PAT": "tu_personal_access_token"
      }
    }
  }
}

La primera vez npx descarga el paquete y Chromium. Después solo pides al asistente que revise la historia de Jira y ejecute el flujo.

Evidencias

Cada ejecución crea evidence/<runId>/ con:

• SUMMARY.md — resumen legible con estado, tabla de tests y links a cada evidencia.
• html-report/ — reporte interactivo de Playwright.
• results.json / report.json — resultados estructurados.
• <storyKey>.spec.ts — copia del test ejecutado.
• test-results/ — trazas, screenshots y videos (solo en fallos, por performance).

El servidor de evidencias expone todo por HTTP en http://127.0.0.1:4731/<runId>/....

Configuración

| Variable | Descripción | Default | |----------|-------------|---------| | JIRA_PAT | Token de Jira (obligatorio) | — | | BASE_URL | URL base del ambiente a probar | se pregunta al usuario | | EVIDENCE_SERVER_PORT | Puerto del servidor de evidencias | 4731 | | EVIDENCE_PUBLIC_URL | URL pública para los links (ej. tunnel) | http://127.0.0.1:<puerto> | | SLOW_MO | ms de slowMo para depurar | 0 |