Skip to main content
Glama
slaid098

antidetect-browser-mcp

by slaid098
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

antidetect-browser-mcp

Standalone MCP server for controlling BitBrowser antidetect profiles via Playwright with built-in behavioral stealth.

Designed for remote browser automation — the agent (OpenCode) runs on Linux and controls BitBrowser profiles on a Windows server via HTTP.

Features

  • 21 MCP tools — profile management, navigation, inspection, interaction, advanced

  • Three-layer stealth — BitBrowser fingerprint + playwright-stealth + behavioral (Bezier mouse, human typing, persona-based RNG)

  • chrome.runtime patch — passes bot.sannysoft.com detection

  • HTTP transport — accessible remotely, works through SSH tunnel

  • Abstract browser client — BitBrowser now, Dolphin Anty / AdsPower later

  • 210 unit tests + 24 live tests — 99.71% coverage

Related MCP server: agent-stealth-browser

Architecture

Linux (OpenCode agent)                Windows (BitBrowser + MCP server)
┌──────────────────┐                 ┌─────────────────────────┐
│ OpenCode         │   SSH tunnel    │ BitBrowser API (:54529) │
│ opencode.json →  │◄──────────────►│ MCP server    (:8765)   │
│ localhost:8765   │                │ Playwright (CDP)        │
└──────────────────┘                 └─────────────────────────┘

Tools

Category

Tools

Profile

open_profile, close_profile, list_profiles

Navigation

navigate, get_url, get_title, reload, wait_for_selector, wait_for_load_state

Inspection

screenshot, get_dom, get_text

Interaction

click, hover, type_text, press_key, scroll

Advanced

execute_js, get_console_logs, get_cookies, upload_file

Stealth layers

  1. BitBrowser fingerprint — hardware-level spoofing (WebGL, Canvas, Audio, WebRTC)

  2. playwright-stealth — navigator.webdriver, plugins, permissions, chrome object

  3. Behavioral — Bezier curve mouse movement, variable-speed typing with occasional typos and correction, persona-based deterministic RNG (same profile = same behavior)

Installation

Prerequisites

  • Python 3.12+

  • uv package manager

  • BitBrowser running on the same machine

Setup

git clone https://github.com/slaid098/antidetect-browser-mcp.git
cd antidetect-browser-mcp
uv sync --extra dev

Configuration

Create config.json in the project root:

{
    "bitbrowser_url": "http://127.0.0.1:54529",
    "mcp_host": "127.0.0.1",
    "mcp_port": 8765
}

Field

Default

Description

bitbrowser_url

http://127.0.0.1:54529

BitBrowser local API URL

mcp_host

0.0.0.0

MCP server bind address. Use 127.0.0.1 for SSH-tunnel-only access

mcp_port

8765

MCP server port

api_token

""

Bearer token for authentication (optional)

Usage

Run MCP server

uv run antidetect-browser-mcp

Connect from OpenCode (Linux)

Add to opencode.json:

{
    "mcpServers": {
        "antidetect-browser": {
            "url": "http://localhost:8765"
        }
    }
}

For remote access, set up an SSH tunnel:

autossh -M 0 -L 8765:localhost:8765 user@<windows-server-ip> -N

Auto-start with NSSM (Windows)

nssm install antidetect-mcp "C:\path\to\uv.exe" "run antidetect-browser-mcp"
nssm set antidetect-mcp AppDirectory "C:\path\to\antidetect-browser-mcp"
nssm set antidetect-mcp Start SERVICE_AUTO_START
nssm start antidetect-mcp

Testing

# Unit tests (no BitBrowser required, 210 tests)
uv run pytest tests/unit/ -m "not live" --cov=src --cov-report=term-missing

# Live tests (requires BitBrowser at 127.0.0.1:54529, 24 tests)
uv run pytest tests/live/ -m "live" --no-cov -v

# All tests
uv run pytest --cov=src --cov-report=term-missing

Quality checks

uv run ruff check src/ tests/
uv run ruff format --check src/ tests/
uv run mypy src/

Project structure

src/antidetect_browser_mcp/
├── server.py              # FastMCP server entry point
├── config.py              # Configuration loading
├── errors.py              # Error formatting helpers
├── browsers/
│   ├── base.py            # Abstract AntidetectBrowserClient
│   ├── models.py          # Pydantic data models
│   └── bitbrowser/        # BitBrowser implementation
│       └── client.py      # BitBrowser API client (httpx)
├── session/
│   ├── manager.py         # SessionManager (Playwright + stealth)
│   └── playwright.py      # Playwright lifecycle
├── stealth/
│   ├── persona.py         # Deterministic RNG per profile
│   ├── mouse.py           # Bezier curve mouse movement
│   ├── keyboard.py        # Human-like typing with typos
│   └── patches.py         # chrome.runtime init script
└── tools/
    ├── profiles.py        # open/close/list profiles
    ├── navigation.py      # navigate, reload, wait helpers
    ├── inspection.py      # screenshot, get_dom, get_text
    ├── interaction.py     # click, hover, type, press, scroll
    └── advanced.py        # execute_js, cookies, console, upload

Tech stack

Component

Technology

MCP framework

FastMCP (PrefectHQ)

Browser automation

Playwright (CDP connection)

Stealth

playwright-stealth + custom patches

HTTP client

httpx

Validation

Pydantic v2

Logging

Loguru

Testing

pytest, pytest-asyncio, pytest-cov

Linting

ruff (strict), mypy (strict)

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

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/slaid098/antidetect-browser-mcp'

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