browser-use-native-windows

Nur für Windows geeigneter MCP-Server zur Steuerung eines echten Chromium-Browsers mit nativen Screenshots, Windows-Barrierefreiheit und node-interception-Maus-/Tastatureingabe.

Es werden kein CDP, Chrome DevTools, Playwright, Puppeteer, Browser-Erweiterungen, DOM-Selektoren, DOM-Snapshots oder JavaScript-Auswertung im Browser verwendet.

Jede Beobachtung erkennt das Browserfenster, den Monitor, die physische Auflösung, die Monitorskalierung und die Fensterposition neu. Fenster- und Monitorgeometrie wird vor nativer Mauseingabe erneut überprüft; Größenänderungen oder Skalierungsänderungen machen die Beobachtung ungültig, sodass der Client den neuen Screenshot beobachten muss, bevor er handelt.

Voraussetzungen

• Windows

• Node.js 20+

• Chromium-basierter Browser: Edge, Chrome, Brave, Chromium, Vivaldi, Opera, Yandex

• node-interception-Treiber

Installieren Sie das native Eingabepaket und den Treiber von einem Administratoren-Terminal aus:

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

Starten Sie Windows nach der Treiberinstallation neu.

Related MCP server: hermes-computer-use

Installation

Aus dem Quellcode:

npm install
npm run build

Optionale globale Installation aus diesem Paketstammverzeichnis:

npm install -g .

Konfiguration

Der MCP liest zuerst die Systemumgebungsvariablen. Wenn eine .env-Datei neben dieser README existiert, wird sie als Fallback geladen. Der MCP startet normal, wenn .env fehlt.

Erstellen Sie .env aus .env.example, wenn Sie feste HTTP- oder Browsereinstellungen wünschen:

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"

Ändern Sie BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH, bevor Sie HTTP außerhalb Ihres Rechners freigeben.

Ausführen

Stdio-Transport:

npm run start:stdio

Streamable HTTP unter /mcp:

npm run start:mcp

Legacy HTTP+SSE unter /sse mit POST-Nachrichten unter /messages:

npm run start:sse

Beide Netzwerktransporte:

npm run start:all

Globale Installation:

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

Der Standard-Netzwerkhost ist 0.0.0.0, sodass /mcp und /sse Verbindungen über localhost und die LAN-Adresse dieses Computers akzeptieren. Die Bearer-Authentifizierung ist auf jedem Netzwerkendpunkt erforderlich.

MCP-Client

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" }

SSE-Kompatibilität:

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

Werkzeuge

• browser_observe: Starten oder übernehmen Sie den Browser und geben Sie eine native Beobachtung zurück.

• browser_act: Führen Sie eine Maus- oder Tastaturaktion gegen ein frisches Beobachtungstoken aus.

• browser_status: Geben Sie Transport, Treiber, Browser, Fenster, Fokus, Monitor, DPI und Beobachtungsstatus zurück.

• browser_stop: Geben Sie den gehaltenen Eingabezustand frei und schließen Sie optional den verfolgten Browser.

Zwangsstopp

Standardmäßiger globaler Hotkey:

Control+F12

Der Watchdog gibt gehaltene Tasten und Maustasten frei und stoppt dann den MCP-Prozess.