deeporax-browser-mcp

MCP server that controls a real Chrome browser through a companion MV3 extension: DOM snapshots with element refs, clicks, typing, screenshots, console and network reads, and navigation.

It drives your browser, with your profile and your logins, and shows an on-page overlay with a Stop button while the agent works.

npx -y deeporax-browser-mcp

Requires Node.js 18+.

Pick a runner

Configs below use npx. Any of these work:

| Runner | command | args | |---|---|---| | npm | npx | ["-y", "deeporax-browser-mcp"] | | Bun | bunx | ["deeporax-browser-mcp"] | | pnpm | pnpm | ["dlx", "deeporax-browser-mcp"] | | Yarn | yarn | ["dlx", "deeporax-browser-mcp"] | | Deno | deno | ["run", "-A", "npm:deeporax-browser-mcp"] | | Global | deeporax-browser-mcp | [] |

A global install starts faster and keeps the extension folder at a stable path:

npm  install -g   deeporax-browser-mcp
bun  add -g       deeporax-browser-mcp
pnpm add -g       deeporax-browser-mcp
yarn global add   deeporax-browser-mcp

Set up your client

Claude Code

claude mcp add deeporax-browser-mcp -- npx -y deeporax-browser-mcp

Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Claude Desktop, Cline, Roo Code, Gemini CLI, JetBrains AI Assistant, Warp, LM Studio:

{
  "mcpServers": {
    "deeporax-browser-mcp": {
      "command": "npx",
      "args": ["-y", "deeporax-browser-mcp"]
    }
  }
}

VS Code / GitHub Copilot (.vscode/mcp.json, note servers):

{
  "servers": {
    "deeporax-browser-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "deeporax-browser-mcp"]
    }
  }
}

Zed (context_servers), Codex CLI (~/.codex/config.toml), opencode, Continue, and Goose are covered in the full docs.

Extension

This package ships an unpacked Chrome extension in extension/.

1. Print the folder path:

   node -e "const p=require('path');console.log(p.join(p.dirname(require.resolve('deeporax-browser-mcp/package.json')),'extension'))"

   Or run the browser_status tool, which prints it.

2. Chrome → chrome://extensions → enable Developer mode → Load unpacked → select that folder

3. Keep Chrome open. The toolbar badge shows ON when the MCP server is connected.

Works in Chrome, Edge, Brave, Arc, and other Chromium browsers. You can also grab extension-dist.zip from GitHub Releases.

Verify

Ask your MCP client:

use browser_status then snapshot my current tab

Agent loop (receipts)

Mutating write tools (browser_type, browser_clear, browser_fill_form) return a structured ActionResult / BulkResult receipt:

• verified + before / after — the DOM value was read back (secrets redacted)
• next.skipScreenshot / next.skipFullSnapshot — when true, do not re-observe just to confirm the write
• refs.valid — whether prior snapshot refs should still work (true on same-document verified writes)
• next.do — continue | fix | observe | wait

Prefer browser_fill_form for multi-field forms. Prefer browser_snapshot over browser_screenshot for structure. Screenshots are for visual/layout QA only.

Docs

Full tool list, overlay behavior, troubleshooting, security notes, and source install:

https://github.com/imfaisii/deeporax-browser-mcp

License

MIT