Cat Burglar
Browser MCP with three engines, proxy pools, remote CDP and change-only page observations
- 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.2Add 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.



