# LvcidPsyche/auto-browser [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/LvcidPsyche/auto-browser  
**GitHub Stars:** 785  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/lvcidpsyche-auto-browser

## Description
Open-source MCP-native browser agent with human takeover via noVNC, reusable auth profiles, and approval/audit rails. Playwright + FastAPI, Docker-based isolated sessions, stdio bridge for Claude Desktop and Cursor.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "auto-browser": {
    "command": "uvx",
    "args": ["auto-browser-mcp"]
  }
}
```

## Documentation

## What LvcidPsyche/auto-browser MCP server does

LvcidPsyche/auto-browser MCP server provides a browser control plane for authorized workflows. Agents can create and observe Playwright-backed sessions, interact with pages, manage tabs, inspect network activity, capture downloads, and work with screenshots, DOM summaries, OCR excerpts, or extracted text. The system also exposes operator-facing controls so a person can view and continue the same session through noVNC.

A central use case is login-once, reuse-later automation. An operator can open a session, complete a login manually when required, save the resulting state as a named authentication profile, and start later sessions from that profile. This is suited to internal dashboards, admin tools, browser debugging, and sites where an automated flow may need human recovery.

## How it works

The application is built around a Playwright browser and a FastAPI controller. Docker Compose starts the local stack, including the controller and browser environment. MCP clients can connect through the HTTP endpoint at `http://127.0.0.1:8000/mcp`, use the convenience tool endpoints, or run the bundled stdio bridge with `uvx auto-browser-mcp`.

LvcidPsyche/auto-browser MCP server offers a curated MCP tool profile by default. Deployments can select the full internal tool surface with `MCP_TOOL_PROFILE=full`. The repository also documents direct REST use, including session creation and observation, so curl-based callers do not need an MCP client.

The operator dashboard is available at port 8000, and the noVNC interface is available at port 6080 in the default local setup. Published ports bind to `127.0.0.1` by default. Codespaces can provision the stack automatically for a hosted development environment.

## Setup and configuration

Clone the repository, change into its directory, and start the stack with:

```bash
docker compose up --build
```

The README identifies this as sufficient for local development with default settings. An optional `.env` file can be created from `.env.example`, and `make doctor` checks the local setup when run from a terminal with Docker access and permission to open localhost sockets.

For the MCP stdio path, install or run the published bridge with:

```bash
uvx auto-browser-mcp
```

The controller still needs to be available for the bridge to connect to. Claude Desktop, Cursor, other HTTP or stdio-capable MCP clients, and direct REST callers are listed as supported connection styles.

## Tools and capabilities

LvcidPsyche/auto-browser MCP server includes documented surfaces for:

- Creating browser sessions and opening a starting URL.
- Observing pages with accessibility information, extracted text, and interactables.
- Finding page content with `browser.find_elements`, using plain text or regular-expression queries with case-insensitive matching and surrounding context.
- Controlling tabs and using screenshots, DOM summaries, OCR excerpts, downloads, and network inspection.
- Saving and reusing named authentication profiles.
- Reviewing recent audit events through the `browser://audit/events` MCP resource.
- Applying approvals, operator identity headers, PII scrubbing, protection profiles, and signed Witness receipts.
- Using noVNC for human takeover of a live browser session.

The repository also describes staged skill candidates derived from verified browser traces, with provenance checks and review-only graduation when mesh identity is configured.

## Limitations and notes

The project is intended for authorized browser workflows. Its stated non-goals include CAPTCHA solving, unauthorized scraping or account automation, and deceptive identity shaping or bypass tooling. Human takeover is available for brittle flows, but it does not turn those unsupported activities into supported use cases.

The default `text` observation preset returns accessibility structure, extracted text, and interactables without screenshots or OCR. Deployments can set `PERCEPTION_PRESET_DEFAULT=text` to make that preset the default. The local quickstart exposes API documentation at `/docs`, a dashboard at `/dashboard`, and noVNC at `/vnc.html?autoconnect=true&resize=scale` on the documented localhost ports.

_Full upstream README: https://allmcps.com/mcp/lvcidpsyche-auto-browser/readme_