VUDA (Visual UI Debug Agent) is a Model Context Protocol server for inspecting and testing web interfaces with Playwright. The MCP server runs locally over standard input/output; its browser can run locally, on Browserbase, on Anchor Browser, or at an existing CDP endpoint. Every tool uses the same selected browser runtime.
Visual UI testing and debugging MCP server with Playwright, screenshots, DOM inspection, workflow validation, and visual diffs.
2026-10-27
Estrelas
83
Ferramentas
—
Disponibilidade
—
Capture full-page, viewport, element, local-file, and batch screenshots.
Map interactive elements and inspect rendered DOM and computed styles.
Execute multi-step UI workflows while preserving browser state.
Monitor console output and analyze page performance.
Compare two rendered states and return a visual diff.
Crawl sitemaps and exercise API endpoints.
Emulate supported Playwright devices.
Quick start
1. Run VUDA
npx -y visual-ui-debug-agent-mcp
The default local mode needs a Chromium-compatible browser. If one is not already available, install the matching browser once:
VUDA reads environment variables normally and automatically loads .env from its working directory. Copy .env.example when running from a source checkout. For an npx installation, either put .env in the MCP process working directory, pass variables in the client configuration, or set DOTENV_CONFIG_PATH to an absolute .env path.
Choose the browser
Mode
Required configuration
Account state
Local (default)
VUDA_BROWSER_PROVIDER=local
VUDA_STORAGE_STATE_PATH, cookie JSON, or a cookie file
All 29 tools keep their existing names and inputs in every mode. Read the MCP resource browser://status to confirm the selected provider, current connection state, session ID, and whether a live view is available. CDP and live-view URLs are never returned.
Import cookies or local state
Cookie injection works with every provider. Supply a Playwright cookie array inline or by file:
For local mode, VUDA_STORAGE_STATE_PATH loads a Playwright storage-state file. Set VUDA_PERSIST_STORAGE_STATE=true to write the updated state back when VUDA exits cleanly. Browserbase Contexts and Anchor profiles are the provider-native choices for state that must survive multiple cloud sessions.
Provider-specific session options remain available without another wrapper or SDK:
VUDA_BROWSERBASE_SESSION_JSON is merged into Browserbase's create-session request.
VUDA_ANCHOR_SESSION_JSON is sent as Anchor's create-session request.
git clone https://github.com/samihalawa/visual-ui-debug-agent-mcp.git
cd visual-ui-debug-agent-mcp
npm ci
npm test
npm test builds the TypeScript server, starts it through the MCP stdio transport, verifies the exact 29-tool inventory, reads a bundled resource, exercises a stateful tool call, and captures a real browser screenshot.
It also validates Browserbase and Anchor session request/cleanup shapes, CDP selection, cookie loading, and the crawler's browser initialization. Provider calls use deterministic mocks in CI; use your own .env for a live cloud session.
Before opening a pull request, also run:
npm audit
npm pack --dry-run
Architecture
VUDA keeps one Playwright control plane across all providers. Local mode creates isolated contexts for page-level analyses; remote modes reuse the provider context so authenticated state survives across tools. VUDA returns screenshots as MCP image content and exposes generated screenshots, browser status, and debugging prompts as MCP resources.
Contributing
Issues and focused pull requests are welcome. See CONTRIBUTING.md for the development workflow and review checklist. Release history is recorded in CHANGELOG.md.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Visual Ui Debug Agent?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Visual Ui Debug Agent precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Visual Ui Debug Agent usa?
Visual Ui Debug Agent roda localmente via stdio.
Quando Visual Ui Debug Agent foi verificado pela última vez?
Última verificação: 2026-10-27. Visual UI testing and debugging MCP server with Playwright, screenshots, DOM inspection, workflow validation, and visual diffs.