zhiqi-li avatar

Browser Mcp Cdp

zhiqi-li/browser-mcp-cdp

Drives your local Chrome via CDP with a clever profile snapshot system: it copies your real Chrome cookies and login state to a temp directory, so agents can navigate Gmail or internal dashboards without touching your actual profile. Ships a shared broker process that multiple MCP clients connect to over a Unix socket, avoiding the overhead of launching Chrome per session. Exposes navigate, evaluate, screenshot, click, fill, and tab management tools. The tradeoff is clear: you get access to your logged-in sessions without credential uploads, but you're letting the LLM execute JavaScript in a browser that sees your session tokens. Broker idles out after 10 minutes and cleans up the temp profile.

tools
13
transport
STDIO
last updated
Apr 23, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

browser_navigateLoad a URL, return final URL + title

Load a URL, return final URL + title

No parameter schema in public metadata yet.

browser_evaluateRun JS in the page, return result

Run JS in the page, return result

No parameter schema in public metadata yet.

browser_screenshotPNG of current page

PNG of current page

No parameter schema in public metadata yet.

browser_clickClick via CSS selector

Click via CSS selector

No parameter schema in public metadata yet.

browser_click_atClick at pixel coordinates (pierces iframes / overlays)

Click at pixel coordinates (pierces iframes / overlays)

No parameter schema in public metadata yet.

browser_fillSet value on input/textarea/select

Set value on input/textarea/select

No parameter schema in public metadata yet.

browser_wait_forWait for a selector to appear

Wait for a selector to appear

No parameter schema in public metadata yet.

browser_get_urlCurrent URL

Current URL

No parameter schema in public metadata yet.

browser_get_textVisible text of page or element

Visible text of page or element

No parameter schema in public metadata yet.

browser_get_htmlouterHTML of page or element

outerHTML of page or element

No parameter schema in public metadata yet.

browser_scrollScroll by (x, y) pixels

Scroll by (x, y) pixels

No parameter schema in public metadata yet.

browser_tabsList open tabs

List open tabs

No parameter schema in public metadata yet.

browser_new_tabOpen a new tab

Open a new tab

No parameter schema in public metadata yet.

Sponsors

Readme

browser-mcp-cdp

A Model Context Protocol (MCP) server that drives your real local Chrome via the Chrome DevTools Protocol. Designed for agents that need access to your logged-in sessions (Gmail, internal dashboards, banking, etc.) without uploading credentials to a cloud service.

Why another browser MCP?

Different tradeoffs from the alternatives:

browser-mcp-cdpPlaywright MCPChrome DevTools MCP
BrowserYour local ChromeManaged Playwright ChromiumYour local Chrome
Login state✅ Snapshot of your profile (cookies, logins, IndexedDB)❌ Fresh profile✅ Real profile (modifies it)
Profile isolation✅ Copy-on-start, real profile untouchedN/A⚠️ Direct attach
Multi-client✅ Shared broker across MCP clients❌ Per-client❌ Per-client
DependenciesNode only (no Playwright download)Playwright + browsersNode only

The profile snapshot pattern means you can ask an agent to "check my email" — it sees your Gmail logged in — but the agent's actions never modify your real Chrome profile. Each session gets a disposable copy.

Install

claude mcp add browser -- npx -y browser-mcp-cdp

View the full README on GitHub

Details

Repository
github.com/zhiqi-li/browser-mcp-cdp
Category
Web & Browser Automation
Package
browser-mcp-cdp
Transport
STDIO
Registry
MCP registry, active

Related Web & Browser Automation MCP servers

View all
1chromedevtools avatarChrome DevTools MCPchromedevtools/chrome-devtools-mcpMCP server for Chrome DevTools55.2Kstars
2angiejones avatarMCP Selenium Serverangiejones/mcp-seleniumAn MCP implementation for Selenium WebDriver411stars
3etairl avatarParallel Browser MCPetairl/parallel-browser-mcpMCP server for parallel browser automation across multiple providers.51stars
4pshivapr avatarSelenium Mcppshivapr/selenium-mcpSelenium Tools for MCP6stars
5ykshah1309 avatarStealth Agent Browserykshah1309/stealth-agent-browser-mcpStealth Chromium MCP server with hybrid AOM + Set-of-Mark vision and Readability extraction.1stars
6dinesh-nalla-se avatarChrome DevTools MCPdinesh-nalla-se/chrome-devtools-mcpMCP server for Chrome DevTools0stars