browser-use-native-windows

Standalone Windows-only MCP server for controlling a real browser through native screenshots, Windows accessibility, and node-interception mouse/keyboard input.

Scope

• Windows only.

• Native input only.

• No CDP, Chrome DevTools, Playwright, Puppeteer, browser extensions, DOM selectors, DOM snapshots, or JavaScript evaluation.

• No dependency on any internal package from this repository.

Related MCP server: ScreenHand

Driver

Install the node-interception driver as administrator, reboot Windows, then start the MCP server.

npx node-interception /install

Stdio

Generic client config:

{
  "mcpServers": {
    "browser-use-native-windows": {
      "command": "node",
      "args": [
        "<repo-root>\\packages\\browser-use-native-windows\\dist\\index.js"
      ],
      "cwd": "<repo-root>\\packages\\browser-use-native-windows"
    }
  }
}

Project MCP settings shape:

{
  "mcpServers": {
    "browser-use-native-windows": {
      "transport": "stdio",
      "command": "node",
      "args": [
        "<repo-root>\\packages\\browser-use-native-windows\\dist\\index.js"
      ],
      "cwd": "<repo-root>\\packages\\browser-use-native-windows"
    }
  }
}

SSE

Start the server:

$env:BROWSER_USE_NATIVE_WINDOWS_SSE_HOST = "0.0.0.0"
$env:BROWSER_USE_NATIVE_WINDOWS_SSE_PORT = "7331"
$env:BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH = "change.me"
node <package-root>\dist\index.js --transport sse

Connect a client:

{
  "mcpServers": {
    "browser-use-native-windows": {
      "transport": "sse",
      "url": "http://<host>:7331/sse",
      "headers": {
        "Authorization": "Bearer change.me"
      }
    }
  }
}

Change BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH before exposing the server beyond local testing.

Tools

• browser_observe: adopt or launch the browser, optionally handle a target URL through native address-bar input, and return a browser-window or browser-owned file-dialog observation.

• browser_act: execute one native action against a matching fresh observation token.

• browser_status: return transport, driver, browser process, HWND, focus, monitor, DPI, and observation state.

• browser_stop: release held input state and optionally close the tracked browser when requested.

Force Stop Hotkey

Default global hotkey:

Control+F12

The hotkey is registered by a watchdog process. When pressed, it releases virtual keys and mouse buttons, then force-kills the MCP process. Use it when native input gets stuck and the agent cannot call browser_stop.

Rare Host Overrides

Normal stdio usage needs no env object.