CDP Bridge MCP
MCP connects an agent to an existing Chromium browser for reading, clicks, input, screenshots and JavaScript execution.
- 305 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent controls signed-in tabs and executes JavaScript, allowing access to data and actions under the user’s identity.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/cdp-bridge-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent controls signed-in tabs and executes JavaScript, allowing access to data and actions under the user’s identity.
This is third-party code. Review the repository files before installing.
What it does
CDP Bridge MCP gives agents control over existing Chrome or Chromium tabs. An extension connects to the server so the agent can inspect page controls, act and check results while retaining the current site sign-in. Tools include tab listing, screenshots and page JavaScript. Tokens separate profiles or users. Users choose local operation or a separately configured network mode.
Who it is for. Web automation engineers testing authenticated workflows in the user’s current tab without another sign-in.
Good fit when
- The needed page is already signed in and open.
- An agent must fill a test form and inspect the result.
- Diagnosis requires a screenshot of a selected tab.
- Several browser profiles need separate agent sessions.
Not a fit when
- The model must not see authenticated page content.
- The task requires reliable control discovery inside iframes.
- A network server would be exposed without a token allowlist.
Example request
List CDP Bridge tabs and read the test page without clicking or submitting forms.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Python 3.10 or later, uv and the Chromium extension are required; MCP alone cannot see tabs. Actions run inside the real browser session and its accounts, so use a test profile and close unrelated pages. Visible-control discovery does not yet include iframe contents, requiring separate checks. In network mode, any token is accepted without an allowlist; configure access before connecting remote clients.
How to disable. Disconnect or disable the extension, then remove the MCP server. Review actions already performed in signed-in accounts.
FAQ
How do I load the extension?
Open `chrome://extensions/`, enable developer mode and load `src/cdp_bridge/tmwd_cdp_bridge` unpacked.
Why is there an initial connection error?
The extension may start before the server; it retries automatically when MCP starts.
Why is the agent’s selected tab not visible?
Selecting the MCP tab and focusing the browser tab are separate actions. Ask the agent to bring it forward.
How do I separate profiles?
Give them different tokens and use the matching token for each client connection.
Why does a previously found control stop working?
Control references are short-lived and single-use. Have the agent inspect the page again.
Discussion
No questions or reviews yet.
Related
MCP serversA Chrome extension with an MCP server: the agent drives your everyday browser with its sessions, tabs, bookmarks and history
An MCP server and Chrome extension that let the agent drive your already open browser with your logged-in sessions, all locally
A browser extension and local MCP server with 254 tools: the agent reads and changes the DOM, clicks and runs JS in Yandex Browser and Chromium tabs
An MCP server that drives your already open Chrome and stops to ask you about a 2FA code, a CAPTCHA, or a choice only you can make
A skill for Amp, Claude Code and Cursor: the agent drives your live Chrome with its open tabs and signed-in accounts through a single debugging toggle
A plugin and MCP server letting an agent drive your open, already logged-in Chrome through an extension with no debugging port.
README in short
Page inspection can return simplified HTML or text. Batch operations and condition waits support longer interactions.