Skip to content

browser-use packaged as an MCP server with dockerized chromium & VNC

Notifications You must be signed in to change notification settings

idoru/browser-use-mcp-server

 
 

Repository files navigation

➡️ 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]
  • we will be adding support for other LLM providers to power browser-use (claude, grok, bedrock, etc)

when building the dockerfile you can add in your own VNC server password:

docker build --build-arg VNC_PASSWORD=klaatubaradanikto .

tools

  • SSE transport
  • browser_use - Initiates browser tasks with URL and action
  • browser_get_result - Retrieves results of async browser tasks

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

Star History Chart

About

browser-use packaged as an MCP server with dockerized chromium & VNC

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 96.3%
  • Dockerfile 3.7%