Multi-Browser Automation MCP Server

A FastMCP 3.x server providing multi-engine browser automation via the MCP protocol. Supports Camoufox (Playwright-based), DrissionPage, and Browser Use (AI agent) with datacenter proxy rotation.

Features

• Three engines: Camoufox (anti-detect), DrissionPage (lightweight), Browser Use (AI agent)

• Proxy support: 25-datacenter proxy pool (off by default), per-engine application

• FastMCP 3.x: Modern SSE/HTTP/stdio transports, Prefect Horizon cloud-ready

• Browser Use agent: LLM-driven automation via OpenAI-compatible API (9Router or direct)

Related MCP server: DrissionPage MCP Server

Quick Start

# Install dependencies
pip install -r requirements.txt

# Install browsers (first time only)
python -m playwright install
camoufox fetch

# Run server (SSE on 127.0.0.1:8000)
fastmcp run server.py

# Or with custom transport/port
fastmcp run server.py --transport http --port 8080
fastmcp run server.py --transport stdio

# Also works directly
python server.py
python server.py --transport http --port 8080

Tools

Proxy

proxies.txt contains 25 datacenter proxies (user:pass@host:port). Proxy is disabled by default.

# Enable with random proxy from pool
await set_proxy(True)

# Enable with specific proxy
await set_proxy(True, "http://user:pass@host:port")

# Disable
await set_proxy(False)

When toggling proxy, any running browser restarts automatically to apply the change.

Browser Use (AI Agent)

Requires an OpenAI-compatible LLM endpoint:

Example task:

await run_browser_use(
    task="Go to github.com, search for 'fastmcp', click first result, return repo stars",
    max_steps=20,
    headless=True
)

Engines

Camoufox (default)

Playwright-based with anti-detection. Best for sites with bot protection.

DrissionPage

Lightweight, fast, no Playwright dependency. Enable first:

await enable_drissionpage(True)
await set_active_engine("drissionpage")

Browser Use

AI agent that plans and executes multi-step tasks. Runs isolated Chromium session.

Project Structure

.
├── server.py         # FastMCP server with all tools
├── requirements.txt  # Pinned dependencies
├── proxies.txt       # Proxy pool (gitignored in public, committed to private)
└── LICENSE

Development

# Check dependencies
pip check

# Lint/type-check (if configured)
ruff check .
mypy .

# Run with auto-reload (FastMCP dev mode)
fastmcp dev server.py

Notes

• proxies.txt contains credentials; it's in .gitignore and only committed to the private repo.

• First run: python -m playwright install && camoufox fetch to download browsers.

• Server binds to 127.0.0.1:8000 by default (SSE). Use --host 0.0.0.0 for LAN access.