Skip to content

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

License

Notifications You must be signed in to change notification settings

newbeb/stealth-browser-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published