@mseep/stealth-browser-mcp
v0.0.1
Published
A MCP Server that provides browser access through playwright with "stealth mode" enabled.
Readme
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 installUsage
# Run the MCP server
bun start
# Development mode
bun dev
# Inspect available tools
bun inspectAvailable Tools
screenshot
Takes screenshots of webpages using a stealth browser.
Parameters:
url(string, required): The URL to navigate tofullPage(boolean, optional, default: true): Whether to capture the entire pageselector(string, optional): CSS selector to capture only a specific elementheadless(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.
