MCP HubMCP Hub
newbeb

stealth-browser-mcp

by: newbeb

A MCP Server that provides browser access through playwright with "stealth mode" enabled.

9created 26/02/2025
Visit
playwright
stealth

📌Overview

Purpose: The Stealth Browser MCP Server aims to provide advanced browsing capabilities that evade detection systems, allowing users to navigate websites and capture screenshots securely.

Overview: This server leverages the Model Context Protocol (MCP) to offer stealth browsing functionalities using Playwright. It incorporates anti-detection techniques, enabling MCP clients to perform tasks without arising suspicion from typical bot detection mechanisms.

Key Features:

  • Stealth Mode: Utilizes puppeteer-extra-plugin-stealth along with playwright-extra to bypass bot detections by modifying browser fingerprints. This ensures that traffic appears as regular user behavior and mitigates fingerprinting through various techniques such as WebGL and canvas.

  • Screenshot Tool: Capable of taking full-page or element-specific screenshots of web pages. It offers both headless and visible browser modes, catering to different user needs for capturing content.

  • MCP Integration: Seamlessly connects browser capabilities with the Model Context Protocol, enhancing interoperability within MCP clients and further extending functionality.

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.