browser-use-native-windows

Только для Windows MCP-сервер для управления реальным браузером Chromium с нативными скриншотами, специальными возможностями Windows и вводом с клавиатуры/мыши через node-interception.

Он не использует CDP, Chrome DevTools, Playwright, Puppeteer, расширения браузера, DOM-селекторы, DOM-снимки или выполнение JavaScript на странице.

Каждое наблюдение заново определяет окно браузера, монитор, физическое разрешение, масштабирование монитора и положение окна. Геометрия окна и монитора проверяется снова перед нативным вводом мыши; изменение размера или масштабирования делает наблюдение недействительным, поэтому клиент должен получить новый скриншот перед выполнением действия.

Требования

• Windows

• Node.js 20+

• Браузер на основе Chromium: Edge, Chrome, Brave, Chromium, Vivaldi, Opera, Yandex

• Драйвер node-interception

Установите нативный пакет ввода и драйвер из терминала администратора:

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

Перезагрузите Windows после установки драйвера.

Related MCP server: hermes-computer-use

Установка

Из исходного кода:

npm install
npm run build

Опциональная глобальная установка из корня этого пакета:

npm install -g .

Конфигурация

MCP сначала считывает системные переменные окружения. Если файл .env существует рядом с этим README, он загружается как запасной вариант. MCP запускается нормально, если .env отсутствует.

Создайте .env из .env.example, когда вам нужны фиксированные настройки HTTP или браузера:

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"

Измените BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH перед тем, как открыть HTTP-доступ за пределы вашей машины.

Запуск

Транспорт Stdio:

npm run start:stdio

Streamable HTTP на /mcp:

npm run start:mcp

Устаревший HTTP+SSE на /sse с POST-сообщениями на /messages:

npm run start:sse

Оба сетевых транспорта:

npm run start:all

Глобальная установка:

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

Хост сети по умолчанию — 0.0.0.0, поэтому /mcp и /sse принимают соединения через localhost и LAN-адрес этого компьютера. Аутентификация Bearer требуется на каждой сетевой конечной точке.

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

Совместимость с SSE:

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

Инструменты

• browser_observe: запустить или подключиться к браузеру и вернуть нативное наблюдение.

• browser_act: выполнить одно действие мыши или клавиатуры с использованием свежего токена наблюдения.

• browser_status: вернуть состояние транспорта, драйвера, браузера, окна, фокуса, монитора, DPI и наблюдения.

• browser_stop: освободить удерживаемое состояние ввода и опционально закрыть отслеживаемый браузер.

Принудительная остановка

Глобальная горячая клавиша по умолчанию:

Control+F12

Сторожевой процесс освобождает удерживаемые клавиши и кнопки мыши, затем останавливает процесс MCP.