Browser Use Server

A Model Context Protocol server for browser automation using Python scripts. For use with Cline

Features

Browser Operations

• screenshot: Capture a screenshot of a webpage (full page or viewport)
• get_html: Retrieve the HTML content of a webpage
• execute_js: Execute JavaScript on a webpage
• get_console_logs: Get console logs from a webpage

All operations support custom interaction steps (e.g., clicking elements, scrolling) after page load.

Prerequisites

1. (Optional but recommended) Install Xvfb for headless browser automation:

# Ubuntu/Debian
sudo apt-get install xvfb

# CentOS/RHEL
sudo yum install xorg-x11-server-Xvfb

# Arch Linux
sudo pacman -S xorg-server-xvfb

Xvfb (X Virtual Frame Buffer) creates a virtual display, allowing browser automation without detection as a bot. Learn more about Xvfb here.

2. Install Miniconda or Anaconda
3. Create a Conda environment:

conda create -n browser-use python=3.11
conda activate browser-use
pip install -r requirements.txt

4. Set up LLM configuration:

The server supports multiple LLM providers. You can use any of the following API keys:

# Required: Set at least one of these API keys
export GLHF_API_KEY=your_api_key
export GROQ_API_KEY=your_api_key
export OPENAI_API_KEY=your_api_key
export OPENROUTER_API_KEY=your_api_key
export GITHUB_API_KEY=your_api_key
export DEEPSEEK_API_KEY=your_api_key
export GEMINI_API_KEY=your_api_key
export OLLAMA_API_KEY=your_api_key

# Optional: Override default configuration
export MODEL=your_preferred_model  # Override the default model
export BASE_URL=your_custom_url    # Override the default API endpoint
export USE_VISION=false  # Enable/disable vision capabilities (default: false)

The server will automatically use the first available API key it finds. You can optionally customize the model and base URL for any provider using the environment variables.

Installation

Installing via Smithery

To install Browser Use Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ztobs/cline-browser-use-mcp --client claude

1. Clone this repository to /home/YOUR_HOME/Documents/Cline/ directory
2. Install dependencies:

npm install

3. Build the server:

npm run build

MCP Configuration

Add the following configuration to your Cline MCP settings:

"browser-use": {
  "command": "node",
  "args": [
    "/home/YOUR_HOME/Documents/Cline/MCP/browser-use-server/build/index.js"
  ],
  "env": {