How do I use dev-browser-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@dev-browser-mcp navigate to github.com and take a screenshot of the login page" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

dev-browser-mcp

by kamkozlowski

Overview Schema Related Servers Score Discussions

TypeScript

Local

dev-browser-mcp

MCP server for SawyerHood/dev-browser. Agents drive a persistent Chromium (or an already-running Chrome) with sandboxed JavaScript and a small set of structured tools.

Repository: github.com/kamkozlowski/dev-browser-mcp

Scripts run in QuickJS, not Node.js. Named pages persist across tool calls through the dev-browser daemon.

dev-browser (CLI + Playwright Chromium) is a dependency of this package. npm install downloads the CLI and installs Chromium. No global dev-browser install is required. Set DEV_BROWSER_SKIP_CHROMIUM=1 to skip the Chromium download (for example when you only attach to an existing Chrome). DEV_BROWSER_BIN still overrides the bundled CLI.

Install

Clone and build:

git clone https://github.com/kamkozlowski/dev-browser-mcp.git
cd dev-browser-mcp
npm install
npm run build

Or install from the GitHub tarball:

npm pack github:kamkozlowski/dev-browser-mcp
tar -xzf dev-browser-mcp-*.tgz
cd package
npm install
npm run build

Related MCP server: Cloudflare Playwright MCP

Cursor config

Add to ~/.cursor/mcp.json (or project .cursor/mcp.json).

Recommended: bootstrap from GitHub (cache under `~/.cache`)

No local clone needed. On first launch Cursor downloads the package, installs dependencies, builds, and starts the server:

{
  "mcpServers": {
    "dev-browser": {
      "command": "bash",
      "args": [
        "/ABS/PATH/TO/dev-browser-mcp/scripts/bootstrap-mcp.sh"
      ],
      "env": {
        "DEV_BROWSER_HEADLESS": "true"
      }
    }
  }
}

If you do not keep a local clone, use this one-liner (same logic as scripts/bootstrap-mcp.sh):

{
  "mcpServers": {
    "dev-browser": {
      "command": "bash",
      "args": [
        "-lc",
        "CACHE=\"${XDG_CACHE_HOME:-$HOME/.cache}/dev-browser-mcp\"; LOCK=\"$CACHE/.install.lock\"; PKG=\"$CACHE/package\"; ENTRY=\"$PKG/dist/index.js\"; mkdir -p \"$CACHE\"; install() { cd \"$CACHE\" && rm -rf package dev-browser-mcp-*.tgz && npm pack github:kamkozlowski/dev-browser-mcp >/dev/null && tar -xzf dev-browser-mcp-*.tgz && rm -f dev-browser-mcp-*.tgz && cd package && npm install && npm run build; }; if [ ! -f \"$ENTRY\" ]; then ( flock -n 9 || flock 9; [ -f \"$ENTRY\" ] || install ) 9>\"$LOCK\"; fi; [ -f \"$ENTRY\" ] || { echo \"Install failed; rm -rf $CACHE\" >&2; exit 1; }; cd \"$PKG\" && exec node dist/index.js"
      ],
      "env": {
        "DEV_BROWSER_HEADLESS": "true"
      }
    }
  }
}

If the server fails to start with Cannot find module .../dist/index.js, remove the broken cache and retry:

rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}/dev-browser-mcp"

To attach to your running Chrome instead of launching Chromium:

{
  "mcpServers": {
    "dev-browser": {
      "command": "bash",
      "args": [
        "-lc",
        "CACHE=\"${XDG_CACHE_HOME:-$HOME/.cache}/dev-browser-mcp\"; LOCK=\"$CACHE/.install.lock\"; PKG=\"$CACHE/package\"; ENTRY=\"$PKG/dist/index.js\"; mkdir -p \"$CACHE\"; install() { cd \"$CACHE\" && rm -rf package dev-browser-mcp-*.tgz && npm pack github:kamkozlowski/dev-browser-mcp >/dev/null && tar -xzf dev-browser-mcp-*.tgz && rm -f dev-browser-mcp-*.tgz && cd package && npm install && npm run build; }; if [ ! -f \"$ENTRY\" ]; then ( flock -n 9 || flock 9; [ -f \"$ENTRY\" ] || install ) 9>\"$LOCK\"; fi; [ -f \"$ENTRY\" ] || { echo \"Install failed; rm -rf $CACHE\" >&2; exit 1; }; cd \"$PKG\" && exec node dist/index.js"
      ],
      "env": {
        "DEV_BROWSER_CONNECT": "auto",
        "DEV_BROWSER_SKIP_CHROMIUM": "true"
      }
    }
  }
}

Enable remote debugging in Chrome at chrome://inspect/#remote-debugging, or launch with --remote-debugging-port=9222.

Local clone (simple)

After npm install and npm run build in your checkout:

{
  "mcpServers": {
    "dev-browser": {
      "command": "node",
      "args": ["/ABS/PATH/TO/dev-browser-mcp/dist/index.js"],
      "env": {
        "DEV_BROWSER_HEADLESS": "true"
      }
    }
  }
}

Local clone (self-bootstrapping, bash)

Cursor installs and builds on first launch if dist/ is missing:

{
  "mcpServers": {
    "dev-browser": {
      "command": "bash",
      "args": [
        "-lc",
        "REPO=\"/ABS/PATH/TO/dev-browser-mcp\"; if [ ! -f \"$REPO/dist/index.js\" ]; then cd \"$REPO\" && npm install && npm run build; fi; cd \"$REPO\" && exec node dist/index.js"
      ],
      "env": {
        "DEV_BROWSER_HEADLESS": "true"
      }
    }
  }
}

Replace REPO with your checkout path.

Development (TypeScript, no build)

{
  "mcpServers": {
    "dev-browser": {
      "command": "bash",
      "args": [
        "-lc",
        "REPO=\"/ABS/PATH/TO/dev-browser-mcp\"; cd \"$REPO\" && exec npx --yes tsx src/index.ts"
      ],
      "env": {
        "DEV_BROWSER_HEADLESS": "true"
      }
    }
  }
}

Replace REPO with your checkout path.

Tools

Tool	Purpose
`dev_browser_run`	Main tool. Execute a sandboxed Playwright script.
`dev_browser_list_pages`	List tabs: `{id, url, title, name}`
`dev_browser_page_open`	Get/create a named page (or attach by targetId)
`dev_browser_close_page`	Close a named page
`dev_browser_goto`	Navigate
`dev_browser_snapshot`	AI accessibility snapshot (`snapshotForAI`)
`dev_browser_screenshot`	PNG screenshot (also returned as an image)
`dev_browser_click`	Click by CSS selector or snapshot ref
`dev_browser_fill`	Fill an input
`dev_browser_type`	Type character by character
`dev_browser_evaluate`	`eval` JavaScript in the page
`dev_browser_wait_for_selector`	Wait for a selector
`dev_browser_status`	Daemon status
`dev_browser_browsers`	Managed browser instances
`dev_browser_stop`	Stop the daemon
`dev_browser_install`	Install Playwright Chromium

Read dev-browser://guide for the full sandbox API, including page.cua (vision) and page.domCua (DOM ids).

Environment

Variable	Meaning
`DEV_BROWSER_BIN`	Override the bundled `dev-browser` CLI path
`DEV_BROWSER_SKIP_CHROMIUM`	`true` to skip postinstall / auto Chromium setup
`DEV_BROWSER_BROWSER`	Named daemon browser instance (default: `default`)
`DEV_BROWSER_HEADLESS`	`true` to launch Chromium without a window
`DEV_BROWSER_CONNECT`	`auto` / `true` to attach to Chrome, or a CDP URL
`DEV_BROWSER_IGNORE_HTTPS_ERRORS`	`true` for self-signed certs
`DEV_BROWSER_TIMEOUT`	Script timeout in seconds (default: `30`)
`DEV_BROWSER_IDLE_TIMEOUT`	Close idle launched browsers, e.g. `5m`

Per-call browser, connect, headless, ignoreHttpsErrors, and timeoutSeconds override the environment.

How it differs from Playwright MCP

dev-browser is built around one sandboxed script per decision, not a long chain of atomic MCP calls. Use dev_browser_run for anything beyond a single goto/click/fill. Convenience tools exist so common inspect/act steps stay structured.

Unlike benkraus/dev-browser-mcp (Chrome extension + CDP relay), this server wraps the official dev-browser CLI with its QuickJS sandbox and persistent daemon pages.

Development

npm test
npm run typecheck
npm run build

Install Server

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Cloudflare Playwright MCP
Browser Automation App Automation
AI24K
F
license
-
quality
C
maintenance
Enables AI assistants to control a browser through a set of tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.
Updated a year ago (2025-05-30 01:41 UTC)
Cloudflare Playwright MCP
Browser Automation Web Scraping
xvv6u577
F
license
-
quality
C
maintenance
Enables AI assistants to control a browser through a set of tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.
Updated a year ago (2025-06-14 01:08 UTC)
Cloudflare Playwright MCP
q275212
F
license
-
quality
C
maintenance
Enables AI assistants to control a browser through a set of tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.
Updated a year ago (2025-07-21 02:22 UTC)
agent-browser-mcp
Browser Automation Web Scraping OS Automation
335234131
A
license
B
quality
F
maintenance
Enables AI agents to directly control your real Chrome browser with full context including login sessions, cookies, and open tabs. It provides tools for page scanning, JavaScript execution, CDP control, screenshots, and physical mouse/keyboard input for authentic browser automation.
Updated 4 months ago (2026-04-15 12:32 UTC)
20
239
MIT

View all related MCP servers

Related MCP Connectors

Skyvern
AI-powered browser automation — navigate, click, fill forms, and extract data from any website.
browserbasehq-mcp-browserbase
Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…
sncro
Live browser debugging for AI assistants — DOM, console, network via MCP.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kamkozlowski/dev-browser-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

dev-browser-mcp

Install

Cursor config

Recommended: bootstrap from GitHub (cache under ~/.cache)

Local clone (simple)

Local clone (self-bootstrapping, bash)

Development (TypeScript, no build)

Tools

Environment

How it differs from Playwright MCP

Development

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Cloudflare Playwright MCP

Cloudflare Playwright MCP

Cloudflare Playwright MCP

agent-browser-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API

Recommended: bootstrap from GitHub (cache under `~/.cache`)