stealth-browser-mcp

Stealth Browser MCP Server

An MCP (Model Context Protocol) server that provides stealth browser capabilities using Playwright with anti-detection techniques. This server allows MCP clients to navigate to websites and take screenshots while evading common bot detection systems.

Features

• Stealth Mode: Uses puppeteer-extra-plugin-stealth with playwright-extra to bypass bot detections
  • Modifies browser fingerprints to appear as regular user traffic
  • Handles WebGL, canvas, font, plugin and other browser fingerprinting techniques
• Screenshot Tool: Take full-page or element-specific screenshots of any website
  • Supports both headless (default) and visible browser modes
• MCP Integration: Exposes browser capabilities via Model Context Protocol

Installation

# Install dependencies
bun install

Usage

# Run the MCP server
bun start

# Development mode
bun dev

# Inspect available tools
bun inspect

Available Tools

screenshot

Takes screenshots of webpages using a stealth browser.

Parameters:

• url (string, required): The URL to navigate to
• fullPage (boolean, optional, default: true): Whether to capture the entire page
• selector (string, optional): CSS selector to capture only a specific element
• headless (boolean, optional, default: true): Whether to run in headless mode or visible browser mode

Technical Details

This project uses:

• FastMCP for the MCP server implementation
• Playwright for browser automation
• playwright-extra for plugin support
• puppeteer-extra-plugin-stealth for avoiding bot detection

---

This project was built with Bun, a fast all-in-one JavaScript runtime.