browser-use-native-windows

Windows 전용 MCP 서버로, 네이티브 스크린샷, Windows 접근성, node-interception 마우스/키보드 입력을 사용하여 실제 Chromium 브라우저를 제어합니다.

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는 먼저 시스템 환경 변수를 읽습니다. 이 README 옆에 .env 파일이 있으면 대체로 로드됩니다. .env가 없으면 MCP가 정상적으로 시작됩니다.

고정 HTTP 또는 브라우저 설정을 원할 때 .env.example에서 .env를 생성합니다:

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"

HTTP를 머신 외부에 노출하기 전에 BROWSER_USE_NATIVE_WINDOWS_SSE_AUTH를 변경합니다.

실행

Stdio 전송:

npm run start:stdio

/mcp에서 스트리밍 가능 HTTP:

npm run start:mcp

/sse에서 레거시 HTTP+SSE, /messages에서 POST 메시지:

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 스트리밍 가능 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 프로세스를 중지합니다.