➡️ browser-use mcp server

browser-use MCP Server with SSE transport

requirements

• uv

curl -LsSf https://astral.sh/uv/install.sh | sh

quickstart

uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium
uv run server --port 8000

• the .env requires the following:

OPENAI_API_KEY=[your api key]
CHROME_PATH=[only change this if you have a custom chrome build]
PATIENT=false # Set to true if you want api calls to wait for tasks to complete (default is false)

• we will be adding support for other LLM providers to power browser-use (claude, grok, bedrock, etc)

when building the docker image, you can use Docker secrets for VNC password:

# With Docker secrets (recommended for production)
echo "your-secure-password" > vnc_password.txt
docker run -v $(pwd)/vnc_password.txt:/run/secrets/vnc_password your-image-name

# Or during development with the default password
docker build .

tools

• SSE transport
• browser_use - Initiates browser tasks with URL and action
• browser_get_result - Retrieves results of async browser tasks
• VNC server - stream the dockerized browser to your client

VNC

the dockerfile has a vnc server with a default password of browser-use. connect to it:

docker build -t  browser-use-mcp-server .
docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server
git clone https://github.com/novnc/noVNC
cd noVNC
./utils/novnc_proxy --vnc localhost:5900

supported clients

• cursor.ai
• claude desktop
• claude code
• windsurf (windsurf doesn't support SSE yet)

usage

after running the server, add http://localhost:8000/sse to your client UI, or in a mcp.json file:

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

cursor

• ./.cursor/mcp.json

windsurf

• ~/.codeium/windsurf/mcp_config.json

claude

• ~/Library/Application Support/Claude/claude_desktop_config.json
• %APPDATA%\Claude\claude_desktop_config.json

then try asking your LLM the following:

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

help

for issues or interest reach out @ https://cobrowser.xyz

stars