Patchright MCP Server

An undetected drop-in replacement for the official Playwright MCP server, powered by Patchright.

This server gives AI agents (like Claude Desktop, Cursor, Antigravity) the exact same browser automation capabilities as @playwright/mcp, but runs on a stealthy Chromium engine that bypasses Cloudflare, Datadome, and other anti-bot protections.

Features

• 100% Compatible: Exposes all 68+ official Playwright MCP tools (browser_navigate, browser_click, browser_cookie_list, etc.).
• Stealthy: Uses patchright-core under the hood to evade headless browser detection.
• Capabilities Support: Fully supports all official capabilities (--caps=core,vision,pdf,devtools,network,storage,testing).

Installation & Setup

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/patchright-mcp-server.git
   cd patchright-mcp-server

2. Install dependencies:

   npm install

3. Install the stealth browser:

   node index.js install-browser chromium

Configuring in your AI Agent

To use this server, add it to your MCP client's configuration file (e.g., claude_desktop_config.json or mcp_config.json).

{
  "mcpServers": {
    "playwright": {
      "command": "node",
      "args": [
        "/absolute/path/to/patchright-mcp-server/index.js",
        "--caps=core,vision,pdf,devtools,network,storage,testing"
      ]
    }
  }
}

How it works

The official @playwright/mcp is a thin CLI wrapper around the internal tools.decorateMCPCommand function in playwright-core. Because patchright-core is a direct fork of playwright-core, it contains the exact same MCP integration logic. This project simply wires the MCP CLI to use the patchright-core engine instead.