Claude Code Browser Bridge
Give Claude Code eyes and hands in your browser
WebSocket bridge · MCP server · FIFO queue · npm package
# How It Works
┌──────────────────────────────────────────────────────────────┐
│ │
│ Claude Code session 1 ──┐ │
│ Claude Code session 2 ──┤── cli.js --mcp ──┐ │
│ Claude Code session N ──┘ (stdio) │ │
│ ▼ │
│ HTTP POST /tool │
│ │ │
│ ▼ │
│ Bridge (WS :18963) │
│ FIFO tool queue │
│ │ │
│ ▼ │
│ Edge Extension │
│ │ │
│ ▼ │
│ Browser tabs │
│ │
└──────────────────────────────────────────────────────────────┘Multi-Session
N Claude Code sessions share one bridge.
FIFO queue ensures orderly execution.
Localhost Only
Bridge binds to 127.0.0.1.
Optional BRIDGE_TOKEN auth.
Auto-Recovery
Lazy-spawn native host on first connection.
Auto-restart on crash, 15s heartbeat.
CDP reconnect with exponential backoff.
# CLI
claude-chrome-android — Start the bridge server claude-chrome-android --mcp — MCP relay mode (spawned by Claude Code automatically) claude-chrome-android --setup — Register MCP server + install extension claude-chrome-android --stop — Stop a running bridge claude-chrome-android --version — Show version # Environment
| Variable | Default | Description |
|---|---|---|
| BRIDGE_PORT | 18963 | WebSocket / HTTP server port |
| BRIDGE_URL | http://127.0.0.1:18963 | Bridge URL for MCP relay |
| BRIDGE_TOKEN | (empty) | Optional shared secret for auth |
| BRIDGE_LOG_LEVEL | info | debug | info | warn | error |
| CDP_PORT | 9223 | ADB forward port for Chrome DevTools Protocol |
# MCP Tools
The npm package is claude-chrome-android (the CLI command).
It registers with Claude Code under the MCP namespace cfc-bridge, so tools appear
as mcp__cfc-bridge__* in the tool list.
The bridge must be running before starting a Claude Code session.
See the extension page for browser-side details.
read_page Read accessibility tree + full page text
navigate Navigate a tab to a URL
javascript_tool Execute JS via CDP or content script fallback
computer Click, type, scroll via content script events
find Find elements by text, role, or aria-label
form_input Fill form fields with React/Vue compatible dispatch
tabs_context_mcp List open tabs with URLs and titles
tabs_create_mcp Open a new tab
get_page_text Get full page text content
switch_browser Switch between Chrome, Edge, and Edge Canary
read_console_messages Read intercepted console.log output
read_network_requests Monitor network requests via CDP
gif_creator Record multi-step interactions as GIF (60s max)
upload_image Upload an image file to a page
resize_window Resize browser viewport via CDP
shortcuts_list List available keyboard shortcuts on the page
shortcuts_execute Execute a keyboard shortcut
update_plan Update plan display in the browser
# Quick Start
Install the package
Run setup
Registers MCP server with Claude Code and prepares extension install.
Install the extension in Edge
Setup serves the CRX on port 18964 and opens Edge. Tap "Add extension" when prompted.
Start the bridge, then start Claude Code
Bridge must be running before starting Claude Code — MCP tools are loaded at session startup.
# Requirements
● required ○ optional