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: 新しい観測トークンに対して、1つのマウスまたはキーボードアクションを実行します。

• browser_status: トランスポート、ドライバー、ブラウザ、ウィンドウ、フォーカス、モニター、DPI、観測状態を返します。

• browser_stop: 保持されている入力状態を解放し、オプションで追跡中のブラウザを閉じます。

強制停止

デフォルトのグローバルホットキー:

Control+F12

ウォッチドッグは保持されているキーとマウスボタンを解放し、MCPプロセスを停止します。