当前MCP览器

Requirements

• Windows
• Chrome
• Codex Desktop running
• Codex Chrome Extension installed and enabled
• Go 1.23+ if building from source
• Rust 1.85+ if building the rewrite/rust-full branch

The bridge connects to local named pipes created by Codex Desktop. If no pipe is found, start Codex Desktop first and make sure the extension is active.

Installation

Option 1: Install with npm

npm i -g @delicious233/codex-browser-bridge

Option 2: Install with Go

go install github.com/DeliciousBuding/codex-browser-bridge/cmd/bridge@latest

Make sure your Go binary path is available in PATH.

Option 4: Build from source

Current release build:

git clone https://github.com/DeliciousBuding/codex-browser-bridge.git
cd codex-browser-bridge
make build

The binary will be generated at:

bin/codex-browser-bridge.exe

Rust rewrite branch build:

git checkout rewrite/rust-full
cargo check --locked
cargo test --locked
cargo build --locked --release

The Rust binary will be generated at:

target/release/codex-browser-bridge.exe

Quick Start with Claude Code

Add the MCP server to your Claude Code settings.

{
  "mcpServers": {
    "codex-browser": {
      "command": "codex-browser-bridge",
      "args": ["-mode", "mcp"],
      "transport": "stdio"
    }
  }
}

If you built from source, use the absolute path instead:

{
  "mcpServers": {
    "codex-browser": {
      "command": "D:/path/to/codex-browser-bridge/bin/codex-browser-bridge.exe",
      "args": ["-mode", "mcp"],
      "transport": "stdio"
    }
  }
}

Restart Claude Code after editing the settings file.

Then ask the agent things like:

List my open browser tabs.

Open https://example.com in a new tab and take a screenshot.

Claim my current documentation tab and summarize what is visible.

CLI Usage

The binary has three modes.

Option 3: Download a release

Download the latest binary from:

https://github.com/DeliciousBuding/codex-browser-bridge/releases

Then place codex-browser-bridge.exe somewhere in your PATH.

Interactive CLI mode

Useful for debugging the bridge without an MCP client.

codex-browser-bridge -mode cli

Connect to a specific pipe:

codex-browser-bridge -mode cli -pipe "codex-browser-use-<uuid>"

Available CLI commands:

tabs
create
close <tab_id>
user-tabs
claim <tab_id>
nav <tab_id> <url>
snapshot <tab_id>
screenshot <tab_id>
info
ping
try <method> [json_params]
quit

CLI output can include pipe IDs, tab titles, full URLs, screenshots, and page text from logged-in tabs. Redact that output before posting bug reports or feature requests.

Troubleshooting