MCP y salida JSON

¿Para quién es esta página? Para quien quiera conectar becwright a una herramienta de IA o a un script. Si solo quieres que becwright cuide tus commits, no necesitas nada de esto — la instalación normal ya lo hace. Sigue leyendo solo si quieres que un agente de IA (u otro programa) lea los resultados de becwright.

becwright expone sus resultados en formato legible por máquina de dos maneras: una salida JSON para scripts y un servidor MCP para agentes de IA. (MCP — Model Context Protocol — es un enchufe estándar para darles habilidades extra a las herramientas de IA.)

becwright check --json

Igual que becwright check, pero imprime un resumen JSON en vez de texto coloreado y se consume sin parsear. El código de salida no cambia (1 si falló una regla blocking, si no 0).

{
  "rule_count": 3,
  "checked_files": 1,
  "blocked": true,
  "results": [
    {
      "id": "no-debugger-js",
      "severity": "blocking",
      "passed": false,
      "intent": "Do not leave 'debugger;' in JavaScript/TypeScript code.",
      "why_it_matters": "A forgotten 'debugger' halts execution ...",
      "output": "app.js:1\n      > function f(){ debugger; }"
    }
  ]
}

Esto no necesita ninguna dependencia extra y funciona también desde el binario autónomo.

Servidor MCP

becwright mcp levanta un servidor Model Context Protocol sobre stdio, así cualquier agente con soporte MCP (Claude, Cursor, Windsurf, …) obtiene becwright como herramientas estructuradas.

Requiere el extra opcional mcp:

pipx install "becwright[mcp]"     # o: pip install "becwright[mcp]"

Herramientas

Herramienta	Argumentos	Devuelve
check	all_files (bool), path (dir de repo opcional)	el mismo resumen que check --json
list_checks	—	los checks incluidos como {name, description}

Configuración del cliente

Apuntá la config MCP de tu agente al comando:

{
  "mcpServers": {
    "becwright": {
      "command": "becwright",
      "args": ["mcp"]
    }
  }
}

El servidor MCP viene solo con el paquete de Python (no está en el binario de npm). Para uso de CLI/hook sin Python, seguí usando la instalación de npm.