browser-bridge

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • os.homedir — User home directory access in packages/agent-client/src/cli.js
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool acts as a local bridge connecting AI coding agents (like Claude Code, Cursor, or Copilot) to your real, active Chrome browser tabs. It allows the AI to read and interact with the DOM, network traffic, console, and styles of your current browser session.

Security Assessment
Overall Risk: Medium. The tool inherently accesses sensitive data by design. To function, it reads your browser's state, which can include active sessions, cookies, and potentially private user data. The automated audit flagged a warning for accessing the user's home directory (`os.homedir`) within the CLI script, which is typical for configuration files but still requires local file system access. No hardcoded secrets or dangerous execution permissions were detected. However, because it essentially exposes your browser's internal activities and local state to an AI agent, it handles highly sensitive information.

Quality Assessment
The project is actively maintained, with its last push occurring today. It is properly licensed under the standard MIT license. However, community trust and visibility are currently very low; the repository has only 5 GitHub stars, indicating it is a very new or niche project that has not yet been widely vetted by the developer community.

Verdict
Use with caution. While the project is active and well-documented, its extremely low community adoption combined with the inherent risks of exposing live browser session data to AI tools means you should test it in strictly non-sensitive environments first.
SUMMARY

🤖 Browser Bridge for Agentic AI Development - browser extension, MCP, and skilled CLI

README.md

Browser Bridge

Browser Bridge: Connect AI Agent and Browsers

Chrome Web Store status: The extension is currently under review. Until the listing is live, use the unpacked install flow in docs/unpacked-extension.md.

A local bridge between your coding agent and a real Chrome tab. Browser Bridge gives the agent structured access to DOM, styles, layout, console, network, and reversible patches - starting from the actual tab you already have open, with all its real state intact.

See Quickstart to get started in another repo, or browse the rest of the guides in docs/index.md.

Supported Agents

Managed installs support OpenAI Codex, Claude Code, Cursor, GitHub Copilot, OpenCode, Antigravity, Windsurf, and generic .agents layouts for both MCP and CLI skill setup.

OpenAI Codex Claude Code Cursor GitHub Copilot
OpenAI Codex Claude Code Cursor GitHub Copilot
OpenCode Antigravity Windsurf .agents
OpenCode Antigravity Windsurf Generic agents

What it's for

  • Debugging a UI on localhost: read DOM, computed styles, layout, console logs, and network state without a screenshot
  • Verifying a code change actually rendered the expected result in Chrome
  • Patching the live page to prove a fix visually, then moving it into source and rolling the patch back
  • Running structured browser checks from any local agent or IDE, not just one AI product

Why Browser Bridge

Most adjacent tools optimize for different goals. Playwright and headless automation stacks are excellent for deterministic tests and CI - but they start from a clean browser context by design. Claude in Chrome is great for integrated Claude workflows, but is vendor-specific. Generic MCP browser servers offer broad control without the developer-focused depth.

Browser Bridge is optimized for the opposite starting point: inspect the state that already exists in a real tab - logged-in sessions, feature flags, seeded storage, SPA state - use structured reads to understand it, test a patch in place, then fix the source. It's open-source, agent-agnostic, and scoped to explicit tab sessions rather than ambient browser control.

Setup

  1. Install Browser Bridge from the Chrome Web Store
  2. npm install -g @browserbridge/bbx - installs the CLI and native host
  3. In the extension side panel, install MCP or CLI (skill) for your agent of choice
  4. Enable Browser Bridge for the Chrome window you want to inspect/control with the AI agent
  5. Ask your agent to use Browser Bridge via MCP (BB MCP or Browser Bridge MCP), or invoke the browser-bridge / $bbx skill in CLI mode

How it works

  • The extension is scoped to one explicitly enabled Chrome window at a time - no ambient browser access
  • Requests default to the active tab in that window unless a tab is targeted explicitly
  • Sessions are tab and origin scoped, auto-refreshed when possible
  • All patch operations are reversible and session-scoped
  • Structured DOM/style/layout reads are the primary transport; screenshots are a fallback
  • Open-ended investigation should start with structured reads on a smaller, lower-cost subagent when the client supports delegation
  • The native host daemon auto-starts on demand

Documentation

Privacy

Browser Bridge itself routes extension data locally through the Chrome extension, native host, and the local client you choose to connect. Browser Bridge does not operate a Browser Bridge cloud service.

Your connected agent or IDE may still forward tool calls or tool results to remote services under that product's own settings and privacy policy. See PRIVACY.md for the Browser Bridge policy.

License

MIT. See LICENSE.

Yorumlar (0)

Sonuc bulunamadi