Browser Use
Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.
제작자가 쓴 설명(영어 원문)
Stealth browser MCP with three engines, diff observations, site memory, and benchmarks.
이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.
이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
BROWSER_MCP_ALLOW_PRIVATE_NETWORK, BROWSER_MCP_OBSCURA_PATH, BROWSER_MCP_PROFILE필요한 것
어떤 앱을 쓰세요?
위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.
Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요
{
"mcpServers": {
"cat-burglar": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BROWSER_MCP_ALLOW_PRIVATE_NETWORK",
"-e",
"BROWSER_MCP_OBSCURA_PATH",
"-e",
"BROWSER_MCP_PROFILE",
"ghcr.io/drmkdaddy/cat-burglar:v0.3.3"
],
"env": {
"BROWSER_MCP_ALLOW_PRIVATE_NETWORK": "your-value",
"BROWSER_MCP_OBSCURA_PATH": "your-value",
"BROWSER_MCP_PROFILE": "your-value"
}
}
}
}터미널에서 이 명령어를 실행하세요
claude mcp add cat-burglar --env BROWSER_MCP_ALLOW_PRIVATE_NETWORK=your-value --env BROWSER_MCP_OBSCURA_PATH=your-value --env BROWSER_MCP_PROFILE=your-value -- docker run -i --rm -e BROWSER_MCP_ALLOW_PRIVATE_NETWORK -e BROWSER_MCP_OBSCURA_PATH -e BROWSER_MCP_PROFILE ghcr.io/drmkdaddy/cat-burglar:v0.3.3실행하기 전에 빈 값을 채워 주세요.
프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"cat-burglar": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BROWSER_MCP_ALLOW_PRIVATE_NETWORK",
"-e",
"BROWSER_MCP_OBSCURA_PATH",
"-e",
"BROWSER_MCP_PROFILE",
"ghcr.io/drmkdaddy/cat-burglar:v0.3.3"
],
"env": {
"BROWSER_MCP_ALLOW_PRIVATE_NETWORK": "your-value",
"BROWSER_MCP_OBSCURA_PATH": "your-value",
"BROWSER_MCP_PROFILE": "your-value"
}
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"cat-burglar": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BROWSER_MCP_ALLOW_PRIVATE_NETWORK",
"-e",
"BROWSER_MCP_OBSCURA_PATH",
"-e",
"BROWSER_MCP_PROFILE",
"ghcr.io/drmkdaddy/cat-burglar:v0.3.3"
],
"env": {
"BROWSER_MCP_ALLOW_PRIVATE_NETWORK": "your-value",
"BROWSER_MCP_OBSCURA_PATH": "your-value",
"BROWSER_MCP_PROFILE": "your-value"
}
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
BROWSER_MCP_ALLOW_PRIVATE_NETWORK envBROWSER_MCP_OBSCURA_PATH envBROWSER_MCP_PROFILE env이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 10일 점검
레지스트리 이름이 GitHub 계정 DrMkdaddy 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.3.3)은 오늘 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Docker도 있어야 해요.
같은 카테고리에는: Browser Use, Chrome DevTools MCP, MCP Server Browser
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
Cat Burglar plugs a real browser into your agent. It can run patched stealth Chromium, stock Chromium for devtools, or Obscura's 43 MB Rust engine behind one session. It sends diffs instead of full DOM dumps, remembers per-site workflows, and gates high-impact actions.
| Feature | Why it matters |
|---|---|
| Three engines, one server | Pick stealth, devtools fidelity, or a 43 MB footprint for the task. Switch without changing clients. |
| Diffs, not dumps | Stable refs, diff snapshots, and bounded change observations after every action. Less context, fewer round trips. |
| Site memory | Per-origin hints and workflows learned after a successful run. Repeated tasks get shorter. |
| Guardrails on by default | SSRF protection, origin lists, untrusted-content markers, tracker blocking, and a confirmation gate for destructive actions. |
| Works with your agent | Claude Desktop, Claude Code, Cursor, Codex, Gemini CLI, VS Code, Windsurf, Cline, OpenCode, Docker, and any stdio client. |
| Measured | A 12-task local suite with state verification. Adaptive observation cuts text by 29.9% and calls by 15% at the same success rate. |
One line:
curl -fsSL https://raw.githubusercontent.com/DrMkdaddy/cat-burglar/main/scripts/install.sh | bash
From the official MCP Registry: io.github.DrMkdaddy/cat-burglar (OCI image). From GHCR: docker run -i --rm ghcr.io/drmkdaddy/cat-burglar:latest.
The installer adds a cat-burglar binary to your PATH. Install globally with pnpm if you prefer:
pnpm add -g https://github.com/DrMkdaddy/cat-burglar/releases/download/v0.3.3/cat-burglar-mcp-0.3.3.tgz
cat-burglar doctor
The install command prints a ready config for: claude-code, claude-desktop, cursor, codex, gemini, vscode, windsurf, cline, opencode, or generic.
| Client | Setup |
|---|---|
| Claude Code | claude mcp add catburglar -- cat-burglar |
| Claude Desktop, Cursor, Windsurf, Cline | Paste the mcpServers JSON from docs/install.md |
| Codex | codex mcp add catburglar -- cat-burglar |
| Gemini CLI | Add the mcpServers entry to ~/.gemini/settings.json |
| VS Code | Add the servers entry to .vscode/mcp.json |
| OpenCode | Add catburglar under mcp.servers |
| Docker | docker run -i --rm ghcr.io/drmkdaddy/cat-burglar:latest |
Do not name the server browser. OpenCode has a built-in browser toolset with that name, and Code Mode hides overlapping tools.
Quick version:
Install Cat Burglar from https://github.com/DrMkdaddy/cat-burglar as a local MCP server named catburglar.
Run: curl -fsSL https://raw.githubusercontent.com/DrMkdaddy/cat-burglar/main/scripts/install.sh | bash
Then run cat-burglar doctor.
Add the server with command cat-burglar (add --slim if the client loads every tool schema), restart or reconnect the client, and verify by navigating to https://example.com and taking a snapshot. Report the tool count, engine, and page title.
Full base prompt with client-specific steps, verification, and security rules: docs/agent-prompt.md.
<system_context>
You are installing Cat Burglar, a local browser MCP server, for this project.
Add Cat Burglar to the current MCP client and verify that it can drive a browser.
cat-burglar doctor and report the output.catburglar that runs cat-burglar. If the client loads every tool schema into context, add --slim.browser. It collides with OpenCode's built-in browser tools.BROWSER_MCP_ALLOW_PRIVATE_NETWORK=1 only if the user needs localhost.navigate to https://example.com, then snapshot, then close.Report the server name, the tool count, the engine, and the title returned by the test page.
Do not commit secrets. Do not enable private-network access without asking. Use the measured 12-task local numbers if numbers are needed. Do not invent a head-to-head result.
Install and verify Cat Burglar for my agent.
Research:
Use catburglar. Open https://news.ycombinator.com, take a snapshot, read the top five stories with markdown, and give me the titles and links.
Forms and workflows:
Use catburglar. Open the staging signup page, fill the form with test data, submit it, and tell me exactly what changed on the page.
Local app testing:
Use catburglar with engine chromium. Open http://localhost:3000, log in with the seeded test user, open the billing page, capture a screenshot, and report console errors.
Performance:
Use catburglar with engine chromium. Open the product page, start a performance trace, reload, stop the trace, and summarize the long tasks and the three slowest scripts.
| Engine | Best for | Footprint |
|---|---|---|
patchright | Protected sites, logins, anti-bot work | Full Chromium |
chromium | Devtools, console, traces, PDF, local app testing | Full Chromium |
obscura | High-volume reads and low-memory work | About 43 MB |
{ "engine": "obscura", "restart": true }
A running browser cannot change engines in place. Call open with restart: true.
navigate to a page.snapshot to get URL, title, controls, and stable refs.click, fill, or select by ref.markdown to read, extract for structured data, and perf for traces.memory learn after a successful repeatable workflow.Refs stay valid while the element remains in the DOM. If an element leaves the page, the action fails with a stale-ref error instead of clicking a clone.
| Mode | Success | Tool calls | Observation chars | Wall time |
|---|---|---|---|---|
| Full snapshots | 12/12 | 80 | 30,029 | 15.37 s |
| Diff + change observation | 12/12 | 68 | 21,057 | 13.86 s |
Measured on a 12-task local suite with server-side state checks. Profile flash, engine chromium, Node 26. Raw JSON: bench/results/2026-11-09-flash.json.
pnpm bench
pnpm bench:compare
30 tools by default. 14 in --slim mode.
| Group | Tools |
|---|---|
| Lifecycle | open, close, navigate, back, forward, reload, status, tabs |
| Reading | snapshot, markdown, extract, evaluate, screenshot, pdf |
| Interaction | click, fill, type, press, select, hover, scroll, upload, wait |
| State | cookies, storage, stealth, memory |
| Diagnostics | network, console, perf |
extract covers links, tables, JSON-LD, meta tags, text, and CSS field maps. perf covers web vitals, CDP metrics, slow resources, and full Chrome traces.
BROWSER_MCP_RISKY_ACTION_POLICY=ask to require explicit confirmation.Use these as layers in a defense-in-depth setup. For sensitive accounts, run with the ask policy and review the confirmation before approving.
The design follows a review of 2023 to 2026 web-agent work: evaluation error, observation alignment, change observation, memory, planning, and prompt injection. Full review with 40 sources: docs/research/2026-11-browser-agent-research.md.
The LLM harness can run the same 12 tasks against ours, playwright, chrome-devtools, or obscura:
pnpm bench:llm -- --server ours
pnpm install
pnpm build pnpm test pnpm smoke pnpm bench pnpm bench:compare node dist/index.js doctor node dist/index.js install --client claude-desktop
Config file: ~/.config/browser-mcp/config.json. Example: cat-burglar.config.example.json. Environment variables override it.
| Source | License | What we used |
|---|---|---|
| Obscura | Apache-2.0 | Ref-token snapshot ideas, markdown and extract semantics, SSRF posture, tracker list data |
| Playwright MCP | Apache-2.0 | Accessibility-first snapshots, persistent profiles, origin and file policy |
| Chrome DevTools MCP | Apache-2.0 | Performance metrics and traces, network and console inspection |
| Patchright | Apache-2.0 | Stealth Playwright driver |
| browser-use | MIT | Agent action vocabulary and humanized interaction ideas |
The tracker list is the only copied data asset. See NOTICE.
Version 0.3.3. Benchmarked on a 12-task local suite with raw JSON in the repo. The LLM harness can run the same tasks across four servers. Issues and counterexamples are welcome.
MIT. See LICENSE.