Skip to main content
Glama
Sign In
dsh-plugin-browser-qa

dsh-plugin-browser-qa

by thegabopacheco-sudo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

dsh-plugin-browser-qa — QA con navegador real para DeepSeek Harness

Plugin MCP local que abre URLs reales en Chrome o Edge y le da al agente herramientas de QA: navegar, hacer clic, escribir, esperar elementos, capturas de pantalla, consola y red. Sin Playwright, sin navegadores descargados y sin dependencias externas: usa Chrome DevTools Protocol (CDP) sobre WebSocket.

English · Cómo funciona · MIT

Herramientas (10)

Tool

Qué hace

mcp__browser__open

Abre una URL (lista blanca) y espera la carga.

mcp__browser__click

Clic por selector CSS o por texto visible.

mcp__browser__type

Escribe en un input/textarea/contenteditable; opcional enviar formulario.

mcp__browser__wait

Espera milisegundos o hasta que aparezca un selector.

mcp__browser__screenshot

Captura el viewport, la página completa o un elemento; devuelve la imagen dentro del resultado.

mcp__browser__console

Logs y errores de consola capturados (filtrable por nivel/texto).

mcp__browser__network

Requests con método, URL, status, MIME y fallos (filtrable).

mcp__browser__read

Texto visible de la página o de un selector.

mcp__browser__status

Estado del navegador, pestaña, lista blanca y modo.

mcp__browser__close

Cierra la pestaña (y el navegador con shutdown:true).

Related MCP server: mcp-cdp

Instalación

Desde DSH → Settings → Plugins: instala github:thegabopacheco-sudo/dsh-plugin-browser-qa y permite el script de instalación cuando DSH lo pida.

Por CLI (perfiles que no administra la app):

dsh plugin --profile <perfil> add github:thegabopacheco-sudo/dsh-plugin-browser-qa

El postinstall copia el runtime a <DSH_HOME>\plugins\browser-qa.

Requisitos: Windows 10/11, Node ≥ 20 (lo aporta el harness) y Chrome o Edge instalado. El plugin lanza el navegador solo (headless por defecto).

Configuración

Variable

Uso

DSH_BROWSER_ALLOWED_DOMAINS

Lista blanca separada por comas (default: localhost,127.0.0.1,wendigocio.com,.wendigocio.com).

DSH_BROWSER_ALLOW_ALL

1 desactiva la lista blanca (solo para entornos de confianza).

DSH_BROWSER_HEADLESS

0 abre el navegador con ventana (default headless).

DSH_BROWSER_PORT

Puerto de depuración CDP (default 9333).

DSH_BROWSER_PATH

Ruta explícita a chrome.exe / msedge.exe.

DSH_BROWSER_MODE

read-only deshabilita click y type.

DSH_BROWSER_SKIP_POSTINSTALL

1 omite el despliegue del postinstall.

Datos locales: capturas en <DSH_HOME>\cache\browser-qa\shots, auditoría en <DSH_HOME>\cache\browser-qa\audit.jsonl.

Seguridad

  • Lista blanca de dominios en open (configurable).

  • Read-only opcional: sin clic ni escritura.

  • Auditoría de navegación, clics y escritura.

  • Rate limit de 120 acciones por minuto.

  • Las instrucciones del modelo prohíben credenciales reales, compras, envíos o borrados sin confirmación.

  • No lee el perfil del usuario: usa un user-data-dir aislado en el cache.

Uso típico

  1. «Abre http://localhost:3000/owner, tómame una captura y dime qué se ve.»

  2. «Haz clic en el botón Guardar y comprueba si aparece el mensaje.»

  3. «Revisa la consola y la red después de cargar: ¿qué requests fallaron?»

  4. «Escribe prueba en el buscador, envía y captura el resultado.»

Solución de problemas

  • “Install scripts need your permission”: aprueba el postinstall. Si el cartel vuelve en bucle, revisa <perfil>\pnpm-workspace.yaml: los valores de allowBuilds deben ser true (no el placeholder set this to true or false).

  • No encuentra navegador: instala Chrome/Edge o define DSH_BROWSER_PATH.

  • No aparecen las tools: verifica <DSH_HOME>\plugins\browser-qa\server.mjs y la fila mcp-browser-qa; reinicia DSH si hace falta.

  • Dominio bloqueado: agrégalo a DSH_BROWSER_ALLOWED_DOMAINS.

Desarrollo

npm install
npm run build:bundle
cd test; npm install; node connect-test.mjs

Licencia

MIT © thegabopacheco-sudo

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • browsertrack

      litepacks
      F
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to access local browser diagnostics—runtime errors, console logs, network failures, breadcrumbs, DOM snapshots, and screenshots—and run closed-loop verification to debug and confirm fixes.
      26 npm
      -

    • mcp-cdp

      dockndevai
      A
      license
      A
      quality
      B
      maintenance
      Enables agents to inspect and drive Electron or Chrome/Chromium apps via the Chrome DevTools Protocol, exposing DOM snapshots, console logs, network requests, and gated interactions like clicking, typing, and navigating.
      6
      73 npm
      1
      MIT

    • Chrome DevTools MCP

      DevTarlow
      A
      license
      Not graded
      quality
      B
      maintenance
      Gives an agent a real, watchable Chrome window to open and read pages, click and type, take screenshots, and inspect console messages, network requests, and script output. It also records performance traces and runs Lighthouse audits, with each chat getting its own browser that closes when the chat ends.
      1
      MIT