stealth-browser-mcp

stealth-browser-mcp

10
browser_automation

The Stealth Browser MCP Server provides stealth browser functionalities to operate undetected on websites using Playwright and various anti-detection techniques. The server is designed to integrate with MCP clients for tasks like taking screenshots while avoiding bot detections.

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:

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