AIQUAA Playwright MCP Server

Generate Playwright BDD tests, GitHub Actions and Azure Pipelines with business-rule traceability, focused CodeGraph context and persistent Engram memory.

Convertí requisitos en pruebas Playwright BDD trazables, listas para CI y conectadas con las reglas de negocio que protegen.

AIQUAA Playwright MCP Serveres un servidorModel Context Protocolpara equipos de QA que necesitan algo más que código generado: escenarios Gherkin, automatización Playwright, trazabilidad por regla, pipelines reproducibles y cobertura auditable.

npm·última release·reportar un problema

flowchart LR A["Requisito o historia"] --> B["qa_bdd"] B --> C["Escenarios Gherkin"] C --> D["qa_mapear"] D --> E["Tags @rule"] E --> F["qa_pruebas"] F --> G["Playwright + CI"] G --> H["Resultados"] H --> I["qa_cobertura"] I --> J["Cobertura por regla"]

El resultado no es un test aislado. Es una cadena de evidencia:

- cada escenario puede declarar qué regla valida;
- cada ejecución conserva esa relación en el reporter;
- cada regla queda clasificada comopassed,failing,not_runouncovered;
- GitHub Actions y Azure Pipelines reciben artefactos listos para adaptar.

- MCP:http://localhost:3000/mcp
- Health check:http://localhost:3000/health

Para clientes compatibles con Streamable HTTP, usá esta definición como referencia:

{ "mcpServers": { "aiquaa-qa": { "url": "http://localhost:3000/mcp" } } }

La ubicación exacta del archivo cambia según el cliente. El servidor usa Streamable HTTP sin estado y crea un contexto aislado por solicitud.

Generá escenarios BDD para recuperación de contraseña, mapealos a RN-014 y RN-015, y prepará los tests Playwright para GitHub Actions. No ejecutes el navegador.

El agente puede encadenarqa_bdd→qa_mapear→qa_pruebasy devolverte archivos copiables.

Los nombres son breves, en español y fáciles de descubrir:

Todos los inputs usan schemas Zod estrictos. Las tools declaran sus annotations MCP de lectura, escritura, idempotencia y acceso externo.

Según las opciones seleccionadas,qa_pruebaspuede devolver:

features/ ├── steps/*.steps.ts └── support/ ├── auth.setup.ts ├── external-validation.ts └── rule-hooks.ts playwright.config.ts .github/workflows/playwright.yml azure-pipelines.playwright.yml

Además, el paquete exporta extensiones reutilizables:

import AiquaaRuleReporter from "aiquaa-playwright-mcp-server/rule-reporter"; import { ruleIdsFromTags } from "aiquaa-playwright-mcp-server/rule-tags";

El proyecto generado usa las APIs públicas deplaywright-bddy Playwright. No modifica internals del runner.

{ "feature_content": "Feature: Login\nScenario: Acceso válido\nGiven el usuario está en login\nWhen hace clic en \"Ingresar\"\nThen ve \"Inicio\"", "base_url": "https://staging.example.com", "app_context": "El formulario usa labels Email y Contraseña.", "selector_source": "provided_component", "auth": { "login_path": "/login", "username_label": "Email", "password_label": "Contraseña", "submit_name": "Ingresar", "success_url_pattern": "dashboard", "username_env": "TEST_USER", "password_env": "TEST_PASSWORD" }, "browsers": ["chromium"], "ci_targets": ["github_actions", "azure_pipelines"], "response_format": "json" }

npm install -D @playwright/test playwright-bdd aiquaa-playwright-mcp-server npx bddgen npx playwright test

El reporter escribetest-results/aiquaa-rule-results.json, compatible conqa_cobertura.

El generador distingue el origen real de cada locator:

- provided_dom: DOM renderizado inspeccionado;
- provided_component: componente React, Vue, Angular u otro código real;
- provided_test_ids: inventario confirmado dedata-testid;
- estimated: inferido solo desde Gherkin.

Si falta información para implementar una acción o assertion confiable, genera unTODOque falla explícitamente. No produce falsos positivos comprobando únicamente que la página existe.

- No incluye credenciales fallback en código generado.
- auth.setup.tsexige secretos y usa PlaywrightstorageState.
- SMS, email, push y estados externos se consultan mediante variables de entorno.
- El Bearer token recibido por el MCP se usa únicamente para esa solicitud.
- CodeGraph solo puede leer rutas bajoCODEGRAPH_ALLOWED_ROOTS.
- Engram queda limitado a memoria con scope de proyecto.

El passthrough de Bearer protege las llamadas a AIQUAA, pero no reemplaza la autenticación del propio endpoint MCP. Si lo exponés en Internet, protegelo con un gateway o reverse proxy.

La mayoría del flujo funciona sin backend:

- qa_bddacepta texto directo;
- qa_pruebasacepta Gherkin directo;
- qa_mapeares completamente local;
- qa_coberturaacepta un snapshot de reglas.

Para resolver IDs y consultar reglas configurá:

$env:AIQUAA_API_BASE_URL="https://api.example.aiquaa.com" $env:AIQUAA_ACCESS_TOKEN="<token-local>" npx aiquaa-playwright-mcp-server

Las rutas actuales del cliente AIQUAA están centralizadas ensrc/constants.tsy deben confirmarse contra el OpenAPI real:

CodeGraphconstruye contexto estructural enfocado antes de generar tests. Resulta especialmente útil cuando el servidor comparte filesystem con el repositorio bajo prueba.

npm install -g @colbymchenry/codegraph cd /workspace/projects/checkout codegraph init -i export CODEGRAPH_BIN=codegraph export CODEGRAPH_ALLOWED_ROOTS=/workspace/projects

Engramconserva decisiones útiles entre sesiones sin convertir cada tool call en memoria.

export ENGRAM_BIN=engram export ENGRAM_PROJECT_PREFIX=aiquaa-

What: se eligió getByRole para acciones primarias. Why: conserva semántica accesible y evita CSS frágil. Where: features/steps/login.steps.ts. Learned: data-testid queda para controles sin nombre accesible estable.

git clone https://github.com/stevenayal/aiquaa-playwright-mcp-server.git cd aiquaa-playwright-mcp-server npm ci npm test

MIT.playwright-bddmantiene licencia MIT y Playwright licencia Apache-2.0.

Create and manage end-to-end tests using the Octomind platform.