Patchright Stealth Browser

🚀 Patchright Lightweight MCP Server

A streamlined Model Context Protocol (MCP) server that encapsulates the Patchright Node.js SDK, providing browser automation capabilities for AI models. This project focuses on achieving browser automation tasks while avoiding detection by target websites.

🚀 Quick Start

Patchright is an undetected version of Playwright, designed specifically to evade detection. It achieves stealth by fixing various detection techniques (such as Runtime.enable leakage, Console.log satisfaction, etc.). Here are its main features:

• Simple Interface: Offers an easy-to-use API for quick browser automation implementation.
• Stealth Automation: Effectively evades the anti - crawler mechanisms of target websites.
• Model Context Protocol (MCP): Supports a standard interface for interacting with AI models.
• Standard Input Output (Stdio) Transmission: Simplifies the data interaction process.

✨ Features

• Simple Interface: Provides an easy - to - use API for rapid implementation of browser automation.
• Stealth Automation: Effectively evades the anti - crawler mechanisms of target websites.
• Model Context Protocol (MCP): Supports a standard interface for interacting with AI models.
• Standard Input Output (Stdio) Transmission: Simplifies the data interaction process.

📦 Installation

Prerequisites

• Node.js version >= 14.0.0
• npm or Yarn package management tool

Installation Steps

# Clone the repository to your local machine
git clone https://github.com/your-repository.git
cd patchright-mcp

# Install dependencies
npm install

# Build the project
npm run build

💻 Usage Examples

Running the Server

# Start the MCP server
npm start

Integration Guide

Claude Desktop Configuration

Add the following content to config.json:

{
  "mcp": {
    "serverUrl": "http://localhost:3000"
  }
}

VS Code with GitHub Copilot Setup

Install the Model Context Protocol plugin and configure it as follows:

{
  "modelContextProtocol": {
    "servers": [
      {
        "url": "http://localhost:3000",
        "label": "Patchright MCP Server"
      }
    ]
  }
}

Core Functionality

Browser Operations

// Launch the browser and visit a page
await page.load('https://example.com');

// Simulate user input
await page.type('#searchInput', 'test');
await page.click('#submitBtn');

Attribute Checks

// Attribute settings to avoid detection
document.addEventListener('DOMContentLoaded', function() {
  console.log(window);
});

General Usage Example

1. Launch the browser and visit the target page.
2. Simulate user input and interactions.
3. Extract verification information.
4. Close the browser.

Safety Precautions

⚠️ Important Note

Use at your own risk. Please comply with relevant laws and regulations and avoid abusing the technology for illegal activities.

💡 Usage Tip

Do not over - automate to avoid affecting website services.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

Thanks to the following projects for their contributions:

• Patchright - nodejs developed by Kaliiiiiiiiii - Vinyzu
• Model Context Protocol (MCP) for technical support

Docker Usage Instructions

Quick Run

docker run -it --rm dylangroos/patchright-mcp

Build the Image

docker build -t patchright-mcp .

Start the Container

docker run -it --rm patchright-mcp

Docker Hub Image

The latest version has been automatically published to Docker Hub. Access it at: dylangroos/patchright-mcp