browser-use-native-windows

Servidor MCP exclusivo para Windows que controla un navegador Chromium real con capturas de pantalla nativas, accesibilidad de Windows y entrada de ratón/teclado mediante node-interception.

No utiliza CDP, Chrome DevTools, Playwright, Puppeteer, extensiones de navegador, selectores DOM, instantáneas DOM ni evaluación de JavaScript en la página.

Cada observación redetecta la ventana del navegador, el monitor, la resolución física, la escala del monitor y la posición de la ventana. La geometría de la ventana y el monitor se verifica nuevamente antes de la entrada nativa del ratón; los cambios de tamaño o escala invalidan la observación, por lo que el cliente debe observar la nueva captura de pantalla antes de actuar.

Requisitos

• Windows

• Node.js 20+

• Navegador basado en Chromium: Edge, Chrome, Brave, Chromium, Vivaldi, Opera, Yandex

• Controlador node-interception

Instale el paquete de entrada nativa y el controlador desde un terminal de administrador:

npm install -g node-interception
node-interception /install

Reinicie Windows después de la instalación del controlador.

Related MCP server: hermes-computer-use

Instalación

Desde el código fuente:

npm install
npm run build

Instalación global opcional desde la raíz de este paquete:

npm install -g .

Configuración

El MCP lee primero las variables de entorno del sistema. Si existe un archivo .env junto a este README, se carga como respaldo. El MCP se inicia normalmente cuando falta .env.

Cree .env a partir de .env.example cuando desee configuraciones fijas de HTTP o del navegador:

BROWSER_USE_NATIVE_WINDOWS_SSE_HOST= "0.0.0.0"
BROWSER_USE_NATIVE_WINDOWS_SSE_PORT= "7331"
BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH= "change.me"
BROWSER_USE_NATIVE_WINDOWS_BROWSER_EXECUTABLE_PATH= "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
BROWSER_USE_NATIVE_WINDOWS_BROWSER_USER_DATA_DIR= "C:\Users\YOUR_USER\AppData\Local\Microsoft\Edge\User Data"

Cambie BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH antes de exponer HTTP fuera de su máquina.

Ejecución

Transporte Stdio:

npm run start:stdio

HTTP Streamable en /mcp:

npm run start:mcp

HTTP+SSE heredado en /sse con mensajes POST en /messages:

npm run start:sse

Ambos transportes de red:

npm run start:all

Instalación global:

browser-use-native-windows
browser-use-native-windows --transport mcp
browser-use-native-windows --transport sse
browser-use-native-windows --transport all

El host de red predeterminado es 0.0.0.0, por lo que /mcp y /sse aceptan conexiones a través de localhost y la dirección LAN de este equipo. Se requiere autenticación Bearer en cada endpoint de red.

Cliente MCP

Stdio:

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

Codex Streamable HTTP:

[mcp_servers.browser_use_native_windows]
url = "http://<host>:7331/mcp"
http_headers = { "Authorization" = "Bearer change.me" }

Compatibilidad SSE:

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

Herramientas

• browser_observe: iniciar o adoptar el navegador y devolver una observación nativa.

• browser_act: ejecutar una acción de ratón o teclado contra un token de observación nuevo.

• browser_status: devolver el estado del transporte, controlador, navegador, ventana, foco, monitor, DPI y observación.

• browser_stop: liberar el estado de entrada retenido y opcionalmente cerrar el navegador rastreado.

Detención forzada

Tecla de acceso rápido global predeterminada:

Control+F12

El watchdog libera las teclas retenidas y los botones del ratón, luego detiene el proceso MCP.