🌐 Browser MCP Server

The most comprehensive Browser MCP Server for AI agents — 70 tools with human-like behavior, stealth anti-detection, session reuse, multi-browser support, 50+ device presets, and token-optimized outputs.

Built on Playwright + Model Context Protocol.

✨ Key Features

Feature	Description
🤖 Human-Like Behavior	Bezier curve mouse movements, variable-speed typing, smooth scrolling — evades bot detection
🛡️ Stealth Anti-Detection	WebGL spoofing, canvas fingerprint noise, navigator.webdriver hidden, plugin/language spoofing
🔄 Session Reuse	Connect to existing Chrome via CDP or user-data-dir — keeps cookies, logins, tabs
🌍 Multi-Browser	Chromium, Firefox, WebKit — test across all engines
📱 50+ Device Presets	iPhone, iPad, Pixel, Galaxy, OnePlus, Desktop — full viewport/UA/touch emulation
🌐 Proxy Support	HTTP/HTTPS/SOCKS5 proxy with bypass rules
📊 Network Monitoring	Auto-capture all requests/responses, console logs, filter by type
📸 Visual Annotation	mark_page: numbered boxes on interactive elements — massive token savings
💾 Storage State	Save/load cookies + localStorage for cross-session persistence
🎯 Smart Actions	Natural language commands: "click Login", "type hello into search"
📉 Token Optimized	Compact outputs, configurable truncation — saves 60-80% tokens vs competitors
🎬 Video Recording	Record browser sessions for debugging and replay
📍 Geolocation	Override latitude/longitude for location-based testing
🔒 HTTPS Errors	Ignore certificate errors for internal/staging sites

🚀 Quick Start

Install

git clone https://github.com/user/browser-mcp-server.git
cd browser-mcp-server
npm install
npx playwright install
npm run build

Run

# Auto-detect: tries CDP on port 9222, falls back to launching a new browser
node dist/index.js

# Connect to existing Chrome (preserves your logged-in sessions)
chrome --remote-debugging-port=9222
node dist/index.js --cdp http://localhost:9222

# Reuse Chrome profile (keeps all cookies, logins, extensions)
node dist/index.js --user-data-dir "C:\Users\you\AppData\Local\Google\Chrome\User Data"

# Launch Firefox with iPhone emulation and proxy
node dist/index.js --browser firefox --device "iPhone 15" --proxy-server http://proxy:8080

VS Code MCP Configuration

Add to .vscode/mcp.json:

{
  "servers": {
    "browser": {
      "type": "stdio",
      "command": "node",
      "args": ["path/to/browser-mcp-server/dist/index.js"]
    }
  }
}

Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "browser": {
      "command": "node",
      "args": ["path/to/browser-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

🛠️ All 70 Tools

Connection (1)

Tool	Description
`browser_connect`	Connect to browser (CDP/profile/temp launch). Multi-browser, device emulation, proxy.

Tool	Description
`navigate`	Navigate to URL with configurable wait conditions
`go_back`	Go back in browser history
`go_forward`	Go forward in browser history
`reload`	Reload current page
`wait_for_navigation`	Wait for page navigation to complete

Page/Tab Management (4)

Tool	Description
`list_pages`	List all open tabs
`new_page`	Open new tab (optionally with URL)
`close_page`	Close a tab by ID
`focus_page`	Bring a tab to front/focus

Interaction — Human-Like (14)

Tool	Description
`click`	Click element with Bezier curve mouse movement
`type_text`	Type with human-like keystroke timing
`fill_form`	Fill multiple form fields with natural pauses
`select_option`	Select dropdown option by value or label
`check_checkbox`	Check/uncheck checkbox or radio button
`hover`	Hover with natural mouse movement
`press_key`	Press key or combo (Enter, Ctrl+C, Tab, etc.)
`scroll`	Scroll with smooth human-like motion
`scroll_to_element`	Scroll element into view
`wait_for_element`	Wait for element to appear/disappear
`wait_for_text`	Wait for specific text on page
`drag_and_drop`	Drag element to target with natural motion
`upload_file`	Upload file(s) to input
`handle_dialog`	Accept or dismiss browser dialogs

Reading/Observation — Token-Optimized (14)

Tool	Description
`get_page_content`	Get visible text (default 4000 chars)
`get_page_html`	Get HTML (truncated to save tokens)
`get_element_text`	Get element text content
`get_element_attribute`	Get element attribute value
`get_element_value`	Get form element value
`element_exists`	Quick true/false existence check
`element_count`	Count elements matching selector
`get_bounding_box`	Get element position and size
`take_screenshot`	Screenshot page or element (PNG/base64)
`get_accessibility_tree`	Compact ARIA accessibility tree
`get_form_elements`	List form elements (compact format)
`get_links`	List page links (deduplicated)
`get_table_data`	Extract table data as structured JSON
`evaluate_javascript`	Run JavaScript in page context

Cookies & Storage (10)

Tool	Description
`get_cookies`	Get cookies (compact format)
`set_cookies`	Set cookies
`clear_cookies`	Clear all cookies
`get_local_storage`	Get localStorage
`set_local_storage`	Set localStorage key-value pairs
`get_session_storage`	Get sessionStorage
`set_session_storage`	Set sessionStorage key-value pairs
`clear_storage`	Clear localStorage, sessionStorage, or both
`save_storage_state`	Save cookies + localStorage to JSON file
`load_storage_state`	Load cookies + localStorage from JSON file

Network Monitoring & Control (8)

Tool	Description
`wait_for_network_idle`	Wait for all network requests to finish
`wait_for_url`	Wait for URL to match pattern
`wait_for_response`	Wait for network response matching URL
`wait_for_request`	Wait for network request matching URL
`get_network_log`	Get captured network requests/responses
`get_console_logs`	Get captured console messages
`block_urls`	Block URLs by pattern (ads, trackers, etc.)
`set_extra_headers`	Set custom HTTP headers

Device & Viewport (3)

Tool	Description
`set_viewport`	Set viewport size for responsive testing
`emulate_device`	Emulate device (50+ presets)
`list_devices`	List all available device presets

Geolocation & Permissions (3)

Tool	Description
`set_geolocation`	Override browser geolocation
`grant_permissions`	Grant browser permissions
`clear_permissions`	Clear all granted permissions

Frame/iFrame Support (3)

Tool	Description
`list_frames`	List all frames on the page
`execute_in_frame`	Run JavaScript in a specific frame
`click_in_frame`	Click element inside a frame

PDF (1)

Tool	Description
`save_as_pdf`	Save page as PDF (A4, Letter, etc.)

Visual Annotation — mark_page (5)

Tool	Description
`mark_page`	Annotate page with numbered boxes on interactive elements
`unmark_page`	Remove annotations
`click_element`	Click by index from mark_page
`type_into_element`	Type into element by index from mark_page
`mark_page_and_screenshot`	Mark + screenshot (best for visual agents)

Smart Tools (2)

Tool	Description
`get_page_summary`	Ultra-compact page summary (minimal tokens)
`smart_action`	Natural language browser action

Browser Management (2)

Tool	Description
`get_browser_info`	Get browser config details
`close_browser`	Close browser and cleanup

📱 Supported Device Presets (50+)

iPhones: SE, 12 Mini, 12, 12 Pro, 12 Pro Max, 13, 13 Pro, 14, 14 Pro, 14 Pro Max, 15, 15 Pro, 15 Pro Max, 16 Pro Max

iPads: Mini, Air, Pro 11, Pro 12.9, 10th Gen

Android: Pixel 5, 6, 7, 8 Pro, Galaxy S21, S23 Ultra, Z Fold 5, A54, OnePlus 12, Moto G, Xiaomi 14, Huawei P60

Desktop: Chrome 1920x1080, Chrome 1440, Firefox, Safari, Edge, Small Laptop, Ultrawide

Landscape: iPhone Landscape, iPad Landscape, Android Landscape

🔧 CLI Options

CONNECTION:
  --cdp <url>                 Connect via Chrome DevTools Protocol
  --user-data-dir <path>      Launch browser with user profile
  --executable-path <path>    Path to browser executable

BROWSER:
  --browser <engine>          chromium, firefox, or webkit (default: chromium)
  --headless                  Run in headless mode
  --timeout <ms>              Default action timeout (default: 30000)

VIEWPORT & DEVICE:
  --viewport <WxH>            Viewport size, e.g. 1920x1080
  --device <name>             Emulate device preset

NETWORK:
  --proxy-server <url>        Proxy URL
  --proxy-bypass <domains>    Domains to bypass proxy
  --ignore-https-errors       Ignore HTTPS certificate errors
  --block-service-workers     Block service workers

CONTEXT:
  --user-agent <string>       Custom user agent
  --locale <locale>           Browser locale (e.g. en-US)
  --timezone <tz>             Timezone (e.g. America/New_York)
  --color-scheme <scheme>     light, dark, or no-preference
  --geolocation <lat,lng>     Override geolocation
  --permissions <list>        Comma-separated permissions

SESSION:
  --storage-state <path>      Load session from JSON file

VIDEO:
  --record-video              Record browser session
  --video-dir <path>          Video output directory

Environment Variables

Variable	CLI Equivalent
`BROWSER_CDP_URL`	`--cdp`
`BROWSER_USER_DATA_DIR`	`--user-data-dir`
`BROWSER_EXECUTABLE_PATH`	`--executable-path`
`BROWSER_ENGINE`	`--browser`
`BROWSER_PROXY`	`--proxy-server`

🐳 Docker

docker build -t browser-mcp-server .
docker run -i browser-mcp-server
docker run -i browser-mcp-server --headless --browser chromium

🏗️ Architecture

src/
├── index.ts           # CLI entry point, MCP server setup
├── browser-manager.ts # Browser lifecycle, multi-engine, stealth, tracking
├── tools.ts           # All 70 MCP tools with human-like behavior
├── resources.ts       # 6 MCP resources (page, cookies, console, network, etc.)
├── human.ts           # Human behavior engine (Bezier curves, natural typing)
├── devices.ts         # 50+ device emulation presets
├── utils.ts           # Shared utilities (selectors, accessibility, text extraction)
└── mark_page.js       # Page annotation script (numbered interactive elements)

🔒 Anti-Detection Features

navigator.webdriver set to false
Chrome runtime spoofed
Permissions query overridden
Plugins and languages spoofed
WebGL vendor/renderer overridden (Intel Iris)
Canvas fingerprint noise injection
connection.rtt consistency
Automation command-line flags disabled
Human-like timing on all interactions

📊 Competitive Advantage

Feature	This Server	Playwright MCP (Microsoft)	mcp-playwright	Browserbase MCP
Human-like behavior	✅ Bezier curves	❌	❌	❌
Stealth anti-detection	✅ Full suite	❌	❌	❌
Session reuse (CDP)	✅	✅	❌	❌ (cloud)
Multi-browser	✅ 3 engines	✅	✅	❌
Device emulation	✅ 50+ presets	❌	✅ 143	❌
Token optimization	✅ Compact outputs	❌	❌	❌
Network monitoring	✅ Auto-capture	❌	❌	❌
mark_page annotation	✅	❌	❌	❌
Smart natural actions	✅	❌	❌	❌
Console log capture	✅ Auto	✅	❌	❌
Video recording	✅	❌	✅	✅
iframe support	✅	✅	❌	❌
Total tools	70	~20	~30	~15

📄 License

MIT