MCP server (`zendriver-mcp`)

zendriver-mcp is a Model Context Protocol server that exposes zendriver-rs through 49 MCP tools, so any MCP-compatible client (Claude Desktop, Claude Code, custom agents) can drive a real, stealth-by-default Chrome browser.

Install

cargo install zendriver-mcp

The default build enables all gated features (interception, expect, cloudflare, fetcher). For a lean build:

cargo install zendriver-mcp --no-default-features

Claude Desktop

{
  "mcpServers": {
    "zendriver": {
      "command": "zendriver-mcp"
    }
  }
}

HTTP mode

zendriver-mcp --http 127.0.0.1:8765

Bind localhost-only by default. It is the operator's responsibility to expose the endpoint via a reverse proxy + mTLS / network policy for remote access.

CLI flags

zendriver-mcp [OPTIONS]

OPTIONS:
    --http <ADDR>                  Run streamable HTTP transport on ADDR
                                   (e.g. 127.0.0.1:8765). Default: stdio.
    --stealth-profile <KIND>       Default stealth profile.
                                   [auto|native|spoof_macos|spoof_linux|spoof_windows]
                                   Default: auto
    --log <FILTER>                 Tracing log filter (EnvFilter syntax).
                                   Default: info
    -h, --help
    -V, --version

Tool surface

49 tools across these categories:

Category	Tools	Count
Lifecycle	`browser_open / _close / _status`	3
Navigation	`browser_goto / _back / _forward / _reload / _wait_for_idle`	5
Tabs	`browser_tab_list / _new / _switch / _close / _activate`	5
Find	`browser_find / _find_all`	2
Actions	`browser_click / _hover / _type / _press / _set_value / _clear / _focus / _scroll_into_view / _upload`	9
Reads	`browser_element_state`	1
Snapshots	`browser_html / _screenshot`	2
Eval	`browser_evaluate / _evaluate_main`	2
Cookies	`browser_cookies_get / _set / _delete / _clear / _persist`	5
Storage	`browser_storage_get / _set / _delete / _clear`	4
Frames	`browser_frame_list`	1
Stealth	`browser_set_stealth_profile`	1
Interception (gated)	`browser_intercept_add_rule / _remove_rule / _list_rules / _clear_rules`	4
Expect (gated)	`browser_expect_register / _await / _cancel`	3
Cloudflare (gated)	`browser_solve_turnstile`	1
Fetcher (gated)	`browser_install_chrome`	1

Full JSON Schema for every tool's input + output is captured in crates/zendriver-mcp/tests/snapshots/ and changes there require an explicit cargo insta accept — the wire shape is reviewed.

Stealth

Stealth is on by default (matching the zendriver library). Configure the default fingerprint via --stealth-profile at server start; switch live via browser_set_stealth_profile (takes effect on the next browser_open).

Troubleshooting

Logs go to stderr in stdio mode — stdout is reserved for MCP JSON-RPC. Use --log debug for verbose CDP-call logging.
Errors include _meta.suggested_next hints when applicable (e.g. ElementNotFound suggests reconnaissance via browser_html or a fresh browser_find_all snapshot).
HTTP smoke test binds 127.0.0.1:18765 by convention — if your environment has that port taken, set a different port via --http.
Real-Chrome integration tests are gated behind cargo feature integration-tests and #[ignore] markers: run via cargo test -p zendriver-mcp --features integration-tests -- --ignored.

Keyboard shortcuts

zendriver-rs