How do I use Browser Agent MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Browser Agent MCP Server Navigate to example.com and take a screenshot" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Browser Agent MCP Server

by dbwang0130

Overview Schema Related Servers Score Discussions

Python

Local

Browser Agent MCP Server

A Model Context Protocol (MCP) server that provides browser automation capabilities through Claude Desktop and other MCP clients.

Features

🌐 Browser Automation: Control web browsers programmatically
🎯 Multiple Engines: Support for Playwright and Selenium
📸 Screenshot Capture: Take screenshots of web pages
🔍 Content Extraction: Extract text and HTML content
🖱️ Interactive Control: Click, type, scroll, and navigate
⚡ Fast Setup: One-click startup with uv
🔧 Flexible Configuration: Environment variables and command-line options

Related MCP server: Browser MCP Bridge

Quick Start

1. Install Dependencies

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and setup the project
git clone <your-repo-url>
cd browser-agent

# Install dependencies and browsers
uv sync
uv run playwright install

2. One-Click Startup

# Start the MCP server
uv run python start.py

Claude Desktop Configuration

1. Install uv

Make sure uv is installed on your system:

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

2. Add Browser Agent Server

Option A: From GitHub Repository (Recommended) Use this configuration to run directly from your GitHub repository:

{
  "mcpServers": {
    "browser-agent": {
      "command": "uv",
      "args": [
        "run",
        "--from",
        "git+https://github.com/galilio/browser-mcp.git",
        "python",
        "start.py"
      ],
      "env": {
        "BROWSER_ENGINE": "playwright",
        "BROWSER_HEADLESS": "false",
        "BROWSER_TIMEOUT": "30000"
      }
    }
  }
}

Option B: Generate GitHub Configuration Run the GitHub configuration generator:

uv run python generate_github_config.py

Option C: Generate Local Configuration Run the configuration generator to get the correct local paths:

uv run python generate_config.py

Option D: Manual Local Configuration Add the following configuration to your MCP servers (replace the path with your actual project directory):

{
  "mcpServers": {
    "browser-agent": {
      "command": "uv",
      "args": ["run", "python", "/path/to/your/browser-agent/start.py"],
      "env": {
        "BROWSER_ENGINE": "playwright",
        "BROWSER_HEADLESS": "false",
        "BROWSER_TIMEOUT": "30000",
        "BROWSER_SCREENSHOT_DIR": "/path/to/your/browser-agent/screenshots"
      }
    }
  }
}

3. Alternative Configurations

GitHub Repository - Headless Mode:

{
  "mcpServers": {
    "browser-agent": {
      "command": "uv",
      "args": [
        "run",
        "--from",
        "git+https://github.com/galilio/browser-mcp.git",
        "python",
        "start.py",
        "--headless"
      ],
      "env": {
        "BROWSER_ENGINE": "playwright"
      }
    }
  }
}

GitHub Repository - Selenium Engine:

{
  "mcpServers": {
    "browser-agent": {
      "command": "uv",
      "args": [
        "run",
        "--from",
        "git+https://github.com/galilio/browser-mcp.git",
        "python",
        "start.py",
        "--engine",
        "selenium"
      ],
      "env": {
        "BROWSER_HEADLESS": "false"
      }
    }
  }
}

4. Restart Claude Desktop

After adding the configuration, restart Claude Desktop for the changes to take effect.

Usage Examples

Once configured, you can use the browser agent in Claude Desktop:

"Navigate to https://example.com"
"Take a screenshot of the page"
"Click the login button"
"Type 'hello world' in the search box"
"Extract all links from the page"
"Scroll down to the bottom"
"Fill out a contact form with my information"

Running the MCP Server

Direct Execution

# Basic startup
uv run python start.py

# Headless mode
uv run python start.py --headless

# Using Selenium engine
uv run python start.py --engine selenium

# Custom timeout
uv run python start.py --timeout 60000

# Custom screenshot directory
uv run python start.py --screenshot-dir ./my_screenshots

Environment Variables

Create a .env file based on env.example:

# Browser Configuration
BROWSER_ENGINE=playwright
BROWSER_HEADLESS=false
BROWSER_TIMEOUT=30000
BROWSER_SCREENSHOT_DIR=./screenshots
BROWSER_USER_AGENT=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
BROWSER_ARGS=--no-sandbox,--disable-dev-shm-usage

# MCP Configuration
MCP_SERVER_NAME=browser-agent

Available Tools

The MCP server provides the following tools:

navigate_to: Navigate to a URL
click_element: Click on an element
type_text: Type text into an element
get_page_content: Get page content (text or HTML)
take_screenshot: Take a screenshot
wait_for_element: Wait for an element to appear
execute_javascript: Execute JavaScript code
scroll_page: Scroll the page
get_elements: Get elements by selector

Troubleshooting

If the server doesn't start:

Make sure Python 3.10+ is installed
Verify that uv sync and uv run playwright install completed successfully
Check that the start.py file is in the correct directory
Try running uv run python start.py --check-only to verify the environment
Ensure uv is installed and available in your PATH
Verify the absolute path in your MCP configuration is correct

For other MCP clients

GitHub Repository Configuration:

{
  "mcpServers": {
    "browser-agent": {
      "command": "uv",
      "args": [
        "run",
        "--from",
        "git+https://github.com/galilio/browser-mcp.git",
        "python",
        "start.py"
      ],
      "env": {
        "BROWSER_ENGINE": "playwright",
        "BROWSER_HEADLESS": "false"
      }
    }
  }
}

Development

Project Structure

browser-agent/
├── browser_agent_mcp/          # Main package
│   ├── __init__.py
│   ├── config.py              # Configuration management
│   ├── browser_controller.py  # Browser automation logic
│   ├── server.py              # MCP server implementation
│   └── main.py                # Entry point
├── start.py                   # One-click startup script
├── generate_config.py         # Configuration generator
├── pyproject.toml            # Project configuration
├── env.example               # Environment variables template
└── README.md                 # This file

Manual Installation

If you prefer manual installation:

# Install Python dependencies
pip install mcp playwright selenium python-dotenv pydantic beautifulsoup4 requests

# Install Playwright browsers
playwright install

# Install Selenium WebDriver (if using Selenium)
# Download ChromeDriver from: https://chromedriver.chromium.org/

License

This project is licensed under the MIT License.

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Browser Agent MCP
Agent Orchestration Browser Automation Web Scraping
imprvhub
A
license
A
quality
B
maintenance
Browser Agent MCP
Last updated 2026-02-05
13
9
41
TypeScript
Mozilla Public 2.0
Browser MCP Bridge
Browser Automation Developer Tools Web Scraping
robhicks
A
license
-
quality
D
maintenance
Bridges browser content, developer tools data, and web page interactions with Claude through MCP. Enables page inspection, DOM analysis, JavaScript execution, console monitoring, network activity tracking, and screenshot capture across multiple browser tabs.
Last updated 2026-04-08
MIT
ZenLink MCP
Browser Automation Web Scraping
JayQuan-McCleary
A
license
B
quality
A
maintenance
Enables browser automation and control through ZenLink, allowing Claude Desktop and other MCP clients to drive a Zen Browser with 75+ tools for navigation, content extraction, interaction, parallel multi-tab operations, and session management.
Last updated 2026-05-20
100
MIT
ultrastealth
Browser Automation Web Scraping
anusoft
A
license
-
quality
B
maintenance
Enables Claude to perform stealth browser automation with anti-detection, including navigation, clicking, typing, screenshots, and network monitoring via an MCP server.
Last updated 2026-07-30
MIT

View all related MCP servers

Related MCP Connectors

browserbasehq-mcp-browserbase
Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…
Skyvern
AI-powered browser automation — navigate, click, fill forms, and extract data from any website.
browser-mcp
Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dbwang0130/browser-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Browser Agent MCP Server

Features

Quick Start

1. Install Dependencies

2. One-Click Startup

Claude Desktop Configuration

1. Install uv

2. Add Browser Agent Server

3. Alternative Configurations

4. Restart Claude Desktop

Usage Examples

Running the MCP Server

Direct Execution

Environment Variables

Available Tools

Troubleshooting

For other MCP clients

Development

Project Structure

Manual Installation

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Browser Agent MCP

Browser MCP Bridge

ZenLink MCP

ultrastealth

Related MCP Connectors

Latest Blog Posts

MCP directory API