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 只能连接互联网上的服务器。请选择其他应用。
你的选择通过 Cookie 保存在这台设备上,无需账户。
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)于今天进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 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.