real-browser-mcp-server 1.3.0 → 1.3.2

package/README.md

@@ -15,7 +15,7 @@ This server is **100% compatible with all major AI IDEs** (Cursor, VS Code, Clin
 
 * **Undetected Browser Engine**: Powered by **Patchright Chromium**, bypassing modern fingerprinting checks (does not expose automation indicators or Webdriver/BiDi flags).
 * **Integrated Ad & Tracker Blocker**: Utilizes `@ghostery/adblocker-playwright` with asynchronous pre-compiled filter caching to `adblocker.bin`, blocking ads and speed-bumps completely offline.
-* **Human-like Interactions**: Integrates **playwright-ghost** (Bézier curves auto-hooking) to transparently simulate human mouse movements, velocity, and natural hover-before-click behaviors.
+* **Human-like Interactions**: Integrates **ghost-cursor-patchright** (Bézier curves) to transparently simulate human mouse movements, velocity, and natural hover-before-click behaviors.
 * **Turnstile Auto-Solver**: Seamlessly detects and bypasses Cloudflare Turnstile widgets.
 * **Anti-Race Condition Guards**: Robust state-guards ensure popup blockers, shims, and adblockers attach exactly once per page, preventing context destruction.
 

package/lib/cjs/index.js

@@ -1,9 +1,8 @@
 const { PlaywrightBlocker } = require("@ghostery/adblocker-playwright");
 const { pageController } = require("./module/pageController.js");
 
-// Dynamically load pure ESM playwright-ghost to be fully compatible with CommonJS
-const playwrightGhostPromise = import("playwright-ghost/patchright");
-const recommendedPromise = import("playwright-ghost/plugins/recommended");
+const { chromium } = require("patchright");
+const { createCursor } = require("ghost-cursor-patchright");
 const fs = require('fs');
 const path = require('path');
 
@@ -72,7 +71,7 @@ function getDefaultHeadless() {
   return envHeadless === 'true';
 }
 
-function applyPuppeteerShims(browser, page) {
+function applyBrowserShims(browser, page) {
   if (page._shimsApplied) return page;
   page._shimsApplied = true;
 
@@ -87,7 +86,7 @@ function applyPuppeteerShims(browser, page) {
     });
   }
 
-  // Cookie shims (Puppeteer → Playwright context)
+  // Cookie shims (Compatibility adapter for Playwright context)
   if (!page.cookies) {
     page.cookies = async (urls) => {
       return await page.context().cookies(urls ? (Array.isArray(urls) ? urls : [urls]) : []);
@@ -133,21 +132,43 @@ function applyPuppeteerShims(browser, page) {
     };
   }
 
-  // Ghost Cursor integration via playwright-ghost auto-hooking
+  // Ghost Cursor integration via ghost-cursor-patchright
+  const cursorPromise = createCursor(page).catch(err => {
+    console.error("Failed to create cursor:", err);
+    return null;
+  });
+
   page.realCursor = {
     move: async (selector, options = {}) => {
       try {
-        await page.hover(selector, options);
+        const cursor = await cursorPromise;
+        if (cursor) {
+          await cursor.move(selector, options);
+        } else {
+          await page.hover(selector, options);
+        }
       } catch (e) {
         // Silently fallback if element is not found
+        try {
+          await page.hover(selector, options);
+        } catch (err) {}
       }
     }
   };
   page.realClick = async (selector, options = {}) => {
-    await page.click(selector, options);
+    try {
+      const cursor = await cursorPromise;
+      if (cursor) {
+        await cursor.click(selector, options);
+      } else {
+        await page.click(selector, options);
+      }
+    } catch (e) {
+      await page.click(selector, options);
+    }
   };
 
-  // Mouse wheel shim (Puppeteer object → Playwright positional args)
+  // Mouse wheel shim (Adapter for Playwright positional args)
   if (page.mouse && page.mouse.wheel) {
     const originalWheel = page.mouse.wheel.bind(page.mouse);
     page.mouse.wheel = async (x, y) => {
@@ -215,16 +236,10 @@ async function connect({
     ...args
   ];
 
-  // Load the dynamic ES Module imports
-  const { default: playwright } = await playwrightGhostPromise;
-  const { default: recommended } = await recommendedPromise;
-  const { chromium } = playwright;
-
   const browser = await chromium.launch({
     headless,
     args: chromiumArgs,
-    proxy: playwrightProxy,
-    plugins: [recommended()]
+    proxy: playwrightProxy
   });
 
   if (xvfbInstance) {
@@ -255,7 +270,7 @@ async function connect({
 
   let page = await context.newPage();
 
-  applyPuppeteerShims(browser, page);
+  applyBrowserShims(browser, page);
 
   page = await pageController({
     browser,
@@ -265,7 +280,7 @@ async function connect({
   });
 
   context.on('page', async (newPage) => {
-    applyPuppeteerShims(browser, newPage);
+    applyBrowserShims(browser, newPage);
     await pageController({
       browser,
       page: newPage,

package/lib/esm/index.mjs

@@ -1,6 +1,5 @@
-import playwright from "playwright-ghost/patchright";
-import recommended from "playwright-ghost/plugins/recommended";
-const { chromium } = playwright;
+import { chromium } from "patchright";
+import { createCursor } from "ghost-cursor-patchright";
 import { PlaywrightBlocker } from "@ghostery/adblocker-playwright";
 import { pageController } from "./module/pageController.mjs";
 import { fileURLToPath } from 'url';
@@ -76,7 +75,7 @@ function getDefaultHeadless() {
   return envHeadless === 'true';
 }
 
-function applyPuppeteerShims(browser, page) {
+function applyBrowserShims(browser, page) {
   if (page._shimsApplied) return page;
   page._shimsApplied = true;
 
@@ -91,7 +90,7 @@ function applyPuppeteerShims(browser, page) {
     });
   }
 
-  // Cookie shims (Puppeteer → Playwright context)
+  // Cookie shims (Compatibility adapter for Playwright context)
   if (!page.cookies) {
     page.cookies = async (urls) => {
       return await page.context().cookies(urls ? (Array.isArray(urls) ? urls : [urls]) : []);
@@ -137,21 +136,43 @@ function applyPuppeteerShims(browser, page) {
     };
   }
 
-  // Ghost Cursor integration via playwright-ghost auto-hooking
+  // Ghost Cursor integration via ghost-cursor-patchright
+  const cursorPromise = createCursor(page).catch(err => {
+    console.error("Failed to create cursor:", err);
+    return null;
+  });
+
   page.realCursor = {
     move: async (selector, options = {}) => {
       try {
-        await page.hover(selector, options);
+        const cursor = await cursorPromise;
+        if (cursor) {
+          await cursor.move(selector, options);
+        } else {
+          await page.hover(selector, options);
+        }
       } catch (e) {
         // Silently fallback if element is not found
+        try {
+          await page.hover(selector, options);
+        } catch (err) {}
       }
     }
   };
   page.realClick = async (selector, options = {}) => {
-    await page.click(selector, options);
+    try {
+      const cursor = await cursorPromise;
+      if (cursor) {
+        await cursor.click(selector, options);
+      } else {
+        await page.click(selector, options);
+      }
+    } catch (e) {
+      await page.click(selector, options);
+    }
   };
 
-  // Mouse wheel shim (Puppeteer object → Playwright positional args)
+  // Mouse wheel shim (Adapter for Playwright positional args)
   if (page.mouse && page.mouse.wheel) {
     const originalWheel = page.mouse.wheel.bind(page.mouse);
     page.mouse.wheel = async (x, y) => {
@@ -221,8 +242,7 @@ export async function connect({
   const browser = await chromium.launch({
     headless,
     args: chromiumArgs,
-    proxy: playwrightProxy,
-    plugins: [recommended()]
+    proxy: playwrightProxy
   });
 
   if (xvfbInstance) {
@@ -253,7 +273,7 @@ export async function connect({
 
   let page = await context.newPage();
 
-  applyPuppeteerShims(browser, page);
+  applyBrowserShims(browser, page);
 
   page = await pageController({
     browser,
@@ -263,7 +283,7 @@ export async function connect({
   });
 
   context.on('page', async (newPage) => {
-    applyPuppeteerShims(browser, newPage);
+    applyBrowserShims(browser, newPage);
     await pageController({
       browser,
       page: newPage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "real-browser-mcp-server",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "MCP Server for Real Browser - Patchright (undetected Playwright fork) with Stealth Mode, Ad Blocker, and Turnstile Auto-Solver for undetectable web automation.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",
@@ -46,7 +46,7 @@
     "@ghostery/adblocker-playwright": "latest",
     "@modelcontextprotocol/sdk": "latest",
     "patchright": "latest",
-    "playwright-ghost": "^0.18.0",
-    "xvfb": "^0.4.0"
+    "ghost-cursor-patchright": "file:../ghost-cursor",
+    "xvfb": "latest"
   }
 }

package/src/mcp/handlers.js

@@ -595,7 +595,7 @@ const handlers = {
     // ═══════════════════════════════════════════════════════════════
     // INJECTED SCRIPT - Silent Handling of Popups
     // Override window.confirm/alert to handle them inside the page context
-    // Note: Using evaluateOnNewDocument (Puppeteer) instead of addInitScript (Playwright)
+    // Note: Using evaluateOnNewDocument shim instead of raw addInitScript
     // ═══════════════════════════════════════════════════════════════
     await pageInstance.evaluateOnNewDocument(() => {
       window.originalConfirm = window.confirm;

package/src/mcp/server.js

@@ -7,7 +7,7 @@
 
 // CRITICAL: Redirect ALL console.log to STDERR before ANY imports
 // MCP uses STDIO transport — STDOUT must contain ONLY JSON-RPC messages.
-// Any console.log from this code or ANY dependency (puppeteer, blocker, etc.)
+// Any console.log from this code or ANY dependency (browser, blocker, etc.)
 // will corrupt the JSON-RPC stream and cause parsing errors.
 const _originalConsoleLog = console.log;
 console.log = function (...args) {

package/typings.d.ts

@@ -1,6 +1,6 @@
-declare module "brave-real-browser-mcp-server" {
-	import type { Browser, Page } from "brave-real-puppeteer-core";
-	import type { GhostCursor } from "ghost-cursor";
+declare module "real-browser-mcp-server" {
+	import type { Browser, Page } from "patchright";
+	import type { GhostCursor } from "ghost-cursor-patchright";
 
 	export function connect(options?: Options): Promise<ConnectResult>;
 
@@ -19,12 +19,12 @@ declare module "brave-real-browser-mcp-server" {
 	interface Options {
 		args?: string[];
 		headless?: boolean;
-		customConfig?: import("brave-real-launcher").Options;
+		customConfig?: any;
 		proxy?: ProxyOptions;
 		turnstile?: boolean;
-		connectOption?: import("brave-real-puppeteer-core").ConnectOptions;
+		connectOption?: any;
 		disableXvfb?: boolean;
-		plugins?: import("puppeteer-extra").PuppeteerExtraPlugin[];
+		plugins?: any[];
 		ignoreAllFlags?: boolean;
 		/** Enable blocker on all pages (default: true) */
 		enableBlocker?: boolean;

package/test/esm/test_option2.js

@@ -1,46 +0,0 @@
-import playwright from "playwright-ghost/patchright";
-import recommended from "playwright-ghost/plugins/recommended";
-
-console.log("🚀 Starting Option 2 Demonstration...");
-
-try {
-  // Launch browser with playwright-ghost overlay & recommended stealth/humanize plugins
-  console.log("Launching browser with Option 2 (playwright-ghost overlay & recommended plugins)...");
-  const browser = await playwright.chromium.launch({
-    headless: false, // Set to false so you can see it if run locally, but works in headless too
-    plugins: [recommended()]
-  });
-  console.log("✅ Browser launched successfully!");
-
-  const context = await browser.newContext();
-  const page = await context.newPage();
-  console.log("✅ Page created!");
-
-  // Go to DrissionPage Detector
-  console.log("Navigating to DrissionPage Detector page...");
-  await page.goto("https://web.archive.org/web/20240913054632/https://drissionpage.pages.dev/", { timeout: 60000 });
-  console.log("✅ Page loaded successfully!");
-
-  console.log("Triggering normal, standard page.click('#detector')!");
-  console.log("👉 Option 2 will intercept this click, calculate a Bézier curve path, scroll it into view, move the cursor humanly, and then click!");
-  
-  const startTime = Date.now();
-  await page.click("#detector");
-  console.log(`✅ Standard click intercepted and completed in ${(Date.now() - startTime) / 1000}s!`);
-
-  // Verify the detector says "not a bot"
-  const isNotBot = await page.evaluate(() => {
-    return document.querySelector('#isBot span').textContent.includes("not");
-  });
-
-  if (isNotBot) {
-    console.log("🎉 SUCCESS! The detector passed: 'not a bot'.");
-  } else {
-    console.log("❌ FAILED! Detected as bot.");
-  }
-
-  await browser.close();
-  console.log("🏁 Browser closed. Demonstration completed successfully.");
-} catch (error) {
-  console.error("❌ An error occurred during the demonstration:", error);
-}

package/test/esm/test_playwright_ghost.js

@@ -1,30 +0,0 @@
-import playwright from "playwright-ghost/patchright";
-import recommended from "playwright-ghost/plugins/recommended";
-
-console.log("🚀 Testing playwright-ghost integration...");
-
-try {
-  const browser = await playwright.chromium.launch({
-    headless: true,
-    plugins: [recommended()]
-  });
-  console.log("✅ Browser launched successfully with playwright-ghost!");
-
-  const context = await browser.newContext();
-  const page = await context.newPage();
-  console.log("✅ Context and page created!");
-
-  console.log("Navigating to simple website...");
-  await page.goto("https://example.com");
-  console.log("✅ Navigated successfully!");
-
-  console.log("Attempting humanized click on link...");
-  const link = page.locator("a");
-  await link.click();
-  console.log("✅ Clicked successfully!");
-
-  await browser.close();
-  console.log("🎉 Test completed successfully!");
-} catch (error) {
-  console.error("❌ Test failed:", error);
-}