browser-use-mcp-server

browser-use-mcp-server

前提条件

• uv - 高速な Python パッケージマネージャー
• Playwright - ブラウザー自動化
• mcp-proxy - stdio モードで必要です

# Install prerequisites
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install mcp-proxy
uv tool update-shell

環境設定

.envファイルを作成します。

OPENAI_API_KEY=your-api-key
CHROME_PATH=optional/path/to/chrome
PATIENT=false  # Set to true if API calls should wait for task completion

インストール

# Install dependencies
uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium

使い方

SSE モード

# Run directly from source
uv run server --port 8000

stdio モード

# 1. Build and install globally
uv build
uv tool uninstall browser-use-mcp-server 2>/dev/null || true
uv tool install dist/browser_use_mcp_server-*.whl

# 2. Run with stdio transport
browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000

クライアントの設定

SSE モードのクライアント設定

{
  "mcpServers": {
    "browser-use-mcp-server": {
      "url": "http://localhost:8000/sse"
    }
  }
}

stdio モードのクライアント設定

{
  "mcpServers": {
    "browser-server": {
      "command": "browser-use-mcp-server",
      "args": [
        "run",
        "server",
        "--port",
        "8000",
        "--stdio",
        "--proxy-port",
        "9000"
      ],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

設定ファイルの場所

クライアント	設定パス
Cursor	./.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Claude（Mac）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude（Windows）	%APPDATA%\Claude\claude_desktop_config.json

機能

• ブラウザー自動化：AI エージェントを通じてブラウザーを操作します
• デュアルトランスポート：SSE と stdio の両プロトコルに対応します
• VNC ストリーミング：ブラウザー自動化をリアルタイムで確認できます
• 非同期タスク：ブラウザー操作を非同期で実行します

ローカル開発

パッケージをローカルで開発およびテストするには、次の手順に従います。

1. 配布用の wheel をビルドします。

   # From the project root directory
   uv build
   

2. グローバルツールとしてインストールします。

   uv tool uninstall browser-use-mcp-server 2>/dev/null || true
   uv tool install dist/browser_use_mcp_server-*.whl
   

3. 任意のディレクトリから実行します。

   # Set your OpenAI API key for the current session
   export OPENAI_API_KEY=your-api-key-here
   
   # Or provide it inline for a one-time run
   OPENAI_API_KEY=your-api-key-here browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
   

4. 変更を加えた後、再ビルドして再インストールします。

   uv build
   uv tool uninstall browser-use-mcp-server
   uv tool install dist/browser_use_mcp_server-*.whl
   

Docker

Docker を使用すると、一貫性のある分離された環境でサーバーを実行できます。

# Build the Docker image
docker build -t browser-use-mcp-server .

# Run the container with the default VNC password ("browser-use")
# --rm ensures the container is automatically removed when it stops
# -p 8000:8000 maps the server port
# -p 5900:5900 maps the VNC port
docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server

# Run with a custom VNC password read from a file
# Create a file (e.g., vnc_password.txt) containing only your desired password
echo "your-secure-password" > vnc_password.txt
# Mount the password file as a secret inside the container
docker run --rm -p8000:8000 -p5900:5900 \
  -v $(pwd)/vnc_password.txt:/run/secrets/vnc_password:ro \
  browser-use-mcp-server

注：ボリュームマウント（-v）の:roフラグを指定すると、セキュリティを強化するため、コンテナ内でパスワードファイルが読み取り専用になります。

VNC ビューアー

# Browser-based viewer
git clone https://github.com/novnc/noVNC
cd noVNC
./utils/novnc_proxy --vnc localhost:5900

デフォルトのパスワード：browser-use（カスタムパスワードの方法で上書きしていない場合）

例

AI に次のように尋ねてみましょう。

open https://news.ycombinator.com and return the top ranked article

サポート

問題や問い合わせについては、cobrowser.xyzをご覧ください。

Star の履歴