Skip to content
MCP server

Cat Burglar

Browser MCP with three engines, proxy pools, remote CDP and change-only page observations

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.5.2
Listing updated
today

Similar MCP servers

About Cat Burglar

Cat Burglar is a free MCP server for browser automation. It runs locally on your machine and is started by your AI client.

Most browser servers resend the whole page after every click. Cat Burglar returns stable element references and a bounded diff of what changed, which the README says cut observation text by 29.9% and calls by 15% at the same success rate on its 12-task local suite.

One session can run on one of three engines: patchright (patched stealth Chromium for protected sites and logins), stock chromium (devtools, traces, PDF, local app testing) or obscura, a roughly 43 MB Rust engine for low-memory reads. It can also attach to Browserbase, Steel, Browserless or any Chrome DevTools Protocol endpoint, and route traffic through HTTP, HTTPS or SOCKS5 proxy pools with sticky or rotating sessions.

Guardrails are on by default: SSRF protection, origin lists, untrusted-content markers and a confirmation gate for destructive actions. When a CAPTCHA appears, the agent opens a window and waits for a person to solve it. Per-site memory shortens repeated tasks. It installs with a script, Docker or pnpm and runs over stdio.

Install

Run in a terminal

claude mcp add cat-burglar --env BROWSER_MCP_CDP_URL='<BROWSER_MCP_CDP_URL>' -- docker run -i --rm -e BROWSER_MCP_CDP_URL ghcr.io/drmkdaddy/cat-burglar:v0.5.2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cat-burglar": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cat-burglar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BROWSER_MCP_CDP_URL",
        "ghcr.io/drmkdaddy/cat-burglar:v0.5.2"
      ],
      "env": {
        "BROWSER_MCP_CDP_URL": "<BROWSER_MCP_CDP_URL>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BROWSER_MCP_ALLOW_PRIVATE_NETWORKSet to 1 to allow localhost and private-network pages.
  • BROWSER_MCP_OBSCURA_PATHPath to the Obscura binary when it is not on PATH.
  • BROWSER_MCP_PROFILEObservation profile: local, flash, frontier, or auto.
  • BROWSER_MCP_PROXY_POOLJSON array or newline-separated HTTP/HTTPS/SOCKS5 proxy URLs.
  • BROWSER_MCP_CDP_URLRemote Chrome DevTools Protocol endpoint for the remote engine.
  • BROWSER_MCP_AUDITSet to 0 to disable the local audit log.

What it does

Three engines
Switch between stealth Chromium, stock Chromium and a 43 MB Rust engine.
Diff observations
Returns only what changed after an action.
Proxy pools
HTTP, HTTPS and SOCKS5 with auth, rotation and geo matching.
Remote browsers
Attaches over CDP to cloud providers or a local Chrome.
Human CAPTCHA handoff
Pauses so a person can finish the challenge.
DevTools capture
HAR, CPU profiles, heap snapshots and coverage on demand.
Safety gates
SSRF guard, origin lists and confirmation for risky actions.

Good for

  • Read and fill forms on a staging site and report what changed
  • Run an agent on a logged-in Chrome session
  • Test a local app and collect console errors
  • Capture a performance trace and summarise slow scripts
  • Run high-volume page reads on a small footprint

Pricing

Free

Free to install; licence terms not published

Cat Burglar FAQ

Which clients does it work with?

Claude Desktop, Claude Code, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Cline, OpenCode and any stdio client.

How do I install it?

Run the install script, use the Docker image ghcr.io/drmkdaddy/cat-burglar, or install the pnpm package.

Can it reach localhost?

Only if you set BROWSER_MCP_ALLOW_PRIVATE_NETWORK=1.

What happens at a CAPTCHA?

It opens the page in a browser window and waits for a person.

Is Cat Burglar free?

Yes. Cat Burglar is free to use.

How do I add Cat Burglar to Claude Code?

Run this command in your terminal: claude mcp add cat-burglar --env BROWSER_MCP_CDP_URL='<BROWSER_MCP_CDP_URL>' -- docker run -i --rm -e BROWSER_MCP_CDP_URL ghcr.io/drmkdaddy/cat-burglar:v0.5.2

What are the best alternatives to Cat Burglar?

The closest alternatives to Cat Burglar are Browser Use, Scrapling MCP Server, Chrome DevTools MCP, Firecrawl MCP Server and Douyin_TikTok_Download_API.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers