Track MCP LogoTrack MCP
Track MCP LogoTrack MCP

The world's largest repository of Model Context Protocol servers. Discover, explore, and submit MCP tools.

Product

  • Categories
  • Top MCP
  • New & Updated
  • Submit MCP

Company

  • About

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

© 2026 TrackMCP. All rights reserved.

Built with ❤️ by Krishna Goyal

    Browser Use Mcp Server

    Browse the web, directly from Cursor etc. Built for the Model Context Protocol to enhance AI capabilities. Python-based implementation.

    760 stars
    Python
    Updated Jul 10, 2025
    browser
    browser-use
    cursor
    mcp
    mcp-server
    playwright

    Table of Contents

    • Prerequisites
    • Environment
    • Installation
    • Usage
    • SSE Mode
    • stdio Mode
    • Client Configuration
    • SSE Mode Client Configuration
    • stdio Mode Client Configuration
    • Config Locations
    • Features
    • Local Development
    • Docker
    • VNC Viewer
    • Example
    • Support
    • Star History

    Table of Contents

    • Prerequisites
    • Environment
    • Installation
    • Usage
    • SSE Mode
    • stdio Mode
    • Client Configuration
    • SSE Mode Client Configuration
    • stdio Mode Client Configuration
    • Config Locations
    • Features
    • Local Development
    • Docker
    • VNC Viewer
    • Example
    • Support
    • Star History

    Documentation

    browser-use-mcp-server

    Prerequisites

    • uv - Fast Python package manager
    • Playwright - Browser automation
    • mcp-proxy - Required for stdio mode
    bash
    # Install prerequisites
    curl -LsSf https://astral.sh/uv/install.sh | sh
    uv tool install mcp-proxy
    uv tool update-shell

    Environment

    Create a .env file:

    bash
    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

    Installation

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

    Usage

    SSE Mode

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

    stdio Mode

    bash
    # 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

    Client Configuration

    SSE Mode Client Configuration

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

    stdio Mode Client Configuration

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

    Config Locations

    ClientConfiguration Path
    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

    Features

    • [x] Browser Automation: Control browsers through AI agents
    • [x] Dual Transport: Support for both SSE and stdio protocols
    • [x] VNC Streaming: Watch browser automation in real-time
    • [x] Async Tasks: Execute browser operations asynchronously

    Local Development

    To develop and test the package locally:

    1. Build a distributable wheel:

    bash
    # From the project root directory
       uv build

    2. Install it as a global tool:

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

    3. Run from any directory:

    bash
    # 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. After making changes, rebuild and reinstall:

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

    Docker

    Using Docker provides a consistent and isolated environment for running the server.

    bash
    # 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

    *Note: The :ro flag in the volume mount (-v) makes the password file read-only inside the container for added security.*

    VNC Viewer

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

    Default password: browser-use (unless overridden using the custom password method)

    Example

    Try asking your AI:

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

    Support

    For issues or inquiries: cobrowser.xyz

    Star History

    Similar MCP

    Based on tags & features

    • WE

      Web Eval Agent

      Python·
      1.2k
    • MC

      Mcp Aoai Web Browsing

      Python·
      30
    • DA

      Davinci Resolve Mcp

      Python·
      327
    • FH

      Fhir Mcp Server

      Python·
      55

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k
    View All MCP Servers

    Similar MCP

    Based on tags & features

    • WE

      Web Eval Agent

      Python·
      1.2k
    • MC

      Mcp Aoai Web Browsing

      Python·
      30
    • DA

      Davinci Resolve Mcp

      Python·
      327
    • FH

      Fhir Mcp Server

      Python·
      55

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k