real-browser-mcp-server 1.0.8 → 1.0.10

package/lib/cjs/index.js

@@ -70,13 +70,10 @@ function getDefaultHeadless() {
   return envHeadless === 'true';
 }
 
-function setupRealPage(browser, page, options = {}) {
+function setupRealPage(browser, page) {
   if (page._setupApplied) return page;
   page._setupApplied = true;
 
-  const headless = options.headless !== undefined ? options.headless : getDefaultHeadless();
-  const showCursor = options.showCursor !== undefined ? options.showCursor : false;
-
   // Enable ad blocker
   if (adBlockerInstance) {
     adBlockerInstance.enableBlockingInPage(page).catch(() => {});
@@ -90,13 +87,11 @@ function setupRealPage(browser, page, options = {}) {
 
   // Ghost Cursor integration - Bézier curve human-like mouse movement
   try {
-    // 5th parameter controls visual cursor (installMouseHelper under the hood)
-    const cursorPromise = createCursor(page, undefined, false, {}, showCursor);
+    const cursor = createCursor(page);
     page.realCursor = {
       move: async (selector, options = {}) => {
         try {
-          const cursor = await cursorPromise;
-          await cursor.move(selector, options);
+          await cursor.actions.move(selector, options);
         } catch (e) {
           // Fallback to native hover if ghost-cursor fails
           try { await page.hover(selector); } catch (_) {}
@@ -105,8 +100,7 @@ function setupRealPage(browser, page, options = {}) {
     };
     page.realClick = async (selector, options = {}) => {
       try {
-        const cursor = await cursorPromise;
-        await cursor.click(selector, options);
+        await cursor.actions.click({ target: selector, ...options });
       } catch (e) {
         // Fallback to native click if ghost-cursor fails
         await page.click(selector, options);
@@ -234,7 +228,6 @@ async function connect({
   proxy = {},
   turnstile = false,
   executablePath = undefined,
-  visualCursor = undefined,
 } = {}) {
   let playwrightProxy = undefined;
   if (proxy && proxy.host && proxy.port) {
@@ -335,9 +328,7 @@ async function connect({
 
   await applyUserAgentOverride(page, modifiedUa, userAgentMetadata);
 
-  const showCursor = visualCursor !== undefined ? visualCursor : false;
-
-  setupRealPage(browser, page, { headless, showCursor });
+  setupRealPage(browser, page);
 
   page = await pageController({
     browser,
@@ -348,7 +339,7 @@ async function connect({
 
   context.on('page', async (newPage) => {
     await applyUserAgentOverride(newPage, modifiedUa, userAgentMetadata);
-    setupRealPage(browser, newPage, { headless, showCursor });
+    setupRealPage(browser, newPage);
     await pageController({
       browser,
       page: newPage,

package/lib/esm/index.mjs

@@ -75,13 +75,10 @@ function getDefaultHeadless() {
   return envHeadless === 'true';
 }
 
-function setupRealPage(browser, page, options = {}) {
+function setupRealPage(browser, page) {
   if (page._setupApplied) return page;
   page._setupApplied = true;
 
-  const headless = options.headless !== undefined ? options.headless : getDefaultHeadless();
-  const showCursor = options.showCursor !== undefined ? options.showCursor : false;
-
   // Enable ad blocker
   if (adBlockerInstance) {
     adBlockerInstance.enableBlockingInPage(page).catch(() => {});
@@ -95,13 +92,11 @@ function setupRealPage(browser, page, options = {}) {
 
   // Ghost Cursor integration - Bézier curve human-like mouse movement
   try {
-    // 5th parameter controls visual cursor (installMouseHelper under the hood)
-    const cursorPromise = createCursor(page, undefined, false, {}, showCursor);
+    const cursor = createCursor(page);
     page.realCursor = {
       move: async (selector, options = {}) => {
         try {
-          const cursor = await cursorPromise;
-          await cursor.move(selector, options);
+          await cursor.actions.move(selector, options);
         } catch (e) {
           // Fallback to native hover if ghost-cursor fails
           try { await page.hover(selector); } catch (_) {}
@@ -110,8 +105,7 @@ function setupRealPage(browser, page, options = {}) {
     };
     page.realClick = async (selector, options = {}) => {
       try {
-        const cursor = await cursorPromise;
-        await cursor.click(selector, options);
+        await cursor.actions.click({ target: selector, ...options });
       } catch (e) {
         // Fallback to native click if ghost-cursor fails
         await page.click(selector, options);
@@ -238,7 +232,6 @@ export async function connect({
   proxy = {},
   turnstile = false,
   executablePath = undefined,
-  visualCursor = undefined,
 } = {}) {
   let playwrightProxy = undefined;
   if (proxy && proxy.host && proxy.port) {
@@ -339,9 +332,7 @@ export async function connect({
 
   await applyUserAgentOverride(page, modifiedUa, userAgentMetadata);
 
-  const showCursor = visualCursor !== undefined ? visualCursor : false;
-
-  setupRealPage(browser, page, { headless, showCursor });
+  setupRealPage(browser, page);
 
   page = await pageController({
     browser,
@@ -352,7 +343,7 @@ export async function connect({
 
   context.on('page', async (newPage) => {
     await applyUserAgentOverride(newPage, modifiedUa, userAgentMetadata);
-    setupRealPage(browser, newPage, { headless, showCursor });
+    setupRealPage(browser, newPage);
     await pageController({
       browser,
       page: newPage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "real-browser-mcp-server",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "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",

package/src/ai/core.js

@@ -90,13 +90,9 @@ class AICore {
       if (element) {
         if (humanLike) {
           try {
-            if (page.realClick) {
-              await page.realClick(selector);
-            } else {
-              const { createCursor } = require('ghost-cursor-patchright');
-              const cursor = await createCursor(page);
-              await cursor.click(selector);
-            }
+            const { createCursor } = require('ghost-cursor-patchright');
+            const cursor = createCursor(page);
+            await cursor.click(selector);
           } catch {
             await element.click();
           }

package/src/mcp/handlers.js

@@ -1239,23 +1239,20 @@ const handlers = {
             notifyProgress('click', 'progress', 'Used force click (JS)');
           } else if (humanLike) {
             try {
+              const { createCursor } = require('ghost-cursor-patchright');
+              const cursor = createCursor(page);
+
               if (context !== page) {
                 const element = await context.$(selector);
                 if (element) {
                   const box = await element.boundingBox();
                   if (box) {
-                    if (page.realCursor) {
-                      await page.realCursor.move({ x: box.x + box.width / 2, y: box.y + box.height / 2 });
-                    }
+                    await cursor.moveTo({ x: box.x + box.width / 2, y: box.y + box.height / 2 });
                     await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2, { clickCount, delay });
                   }
                 }
               } else {
-                if (page.realClick) {
-                  await page.realClick(selector);
-                } else {
-                  await context.click(selector, { clickCount, delay });
-                }
+                await cursor.click(selector);
               }
               notifyProgress('click', 'progress', 'Used human-like cursor movement');
             } catch (e) {
@@ -2005,13 +2002,9 @@ const handlers = {
 
       // Click submit button with human-like behavior
       try {
-        if (page.realClick) {
-          await page.realClick(submitSelector);
-        } else {
-          const { createCursor } = require('ghost-cursor-patchright');
-          const cursor = await createCursor(page);
-          await cursor.click(submitSelector);
-        }
+        const { createCursor } = require('ghost-cursor-patchright');
+        const cursor = createCursor(page);
+        await cursor.click(submitSelector);
       } catch (e) {
         await page.click(submitSelector);
       }
@@ -4773,18 +4766,13 @@ const handlers = {
                 }
               }
             }, identity, String(value));
+          } else {
             // Smart Type
-            if (page.realClick) {
-              await page.realClick(identity);
-            } else {
-              try {
-                const { createCursor } = require('ghost-cursor-patchright');
-                const cursor = await createCursor(page);
-                await cursor.click(identity);
-              } catch (e) {
-                await page.click(identity);
-              }
-            }
+            const { createCursor } = require('ghost-cursor-patchright');
+            const cursor = createCursor(page);
+
+            // Click center of element
+            await cursor.click(identity);
 
             // Clear existing
             await page.evaluate(s => document.querySelector(s).value = '', identity);
@@ -4847,17 +4835,9 @@ const handlers = {
       });
 
       if (submitSelector) {
-        if (page.realClick) {
-          await page.realClick(submitSelector);
-        } else {
-          try {
-            const { createCursor } = require('ghost-cursor-patchright');
-            const cursor = await createCursor(page);
-            await cursor.click(submitSelector);
-          } catch (e) {
-            await page.click(submitSelector);
-          }
-        }
+        const { createCursor } = require('ghost-cursor-patchright');
+        const cursor = createCursor(page);
+        await cursor.click(submitSelector);
 
         try {
           await page.waitForNavigation({ timeout: 5000, waitUntil: 'domcontentloaded' });

package/test/cjs/test.js

@@ -4,7 +4,7 @@ const { connect } = require('../../lib/cjs/index.js');
 
 const realBrowserOption = {
     turnstile: true,
-    headless: false,
+    headless: true,
     customConfig: {}
 }
 
@@ -32,9 +32,7 @@ test.after(async () => {
 
 test('DrissionPage Detector', async () => {
     await page.goto("https://web.archive.org/web/20240913054632/https://drissionpage.pages.dev/", { timeout: 60000 });
-    await page.waitForSelector("#detector", { timeout: 20000 });
     await page.realClick("#detector")
-    await page.waitForSelector("#isBot span", { timeout: 20000 });
     let result = await page.evaluate(() => { return document.querySelector('#isBot span').textContent.includes("not") ? true : false })
     assert.strictEqual(result, true, "DrissionPage Detector test failed!")
 })

package/test/esm/test.mjs

@@ -4,7 +4,7 @@ import { connect } from '../../lib/esm/index.mjs';
 
 const realBrowserOption = {
     turnstile: true,
-    headless: false,
+    headless: true,
     customConfig: {}
 }
 
@@ -32,9 +32,7 @@ test.after(async () => {
 
 test('DrissionPage Detector', async () => {
     await page.goto("https://web.archive.org/web/20240913054632/https://drissionpage.pages.dev/", { timeout: 70000 });
-    await page.waitForSelector("#detector", { timeout: 20000 });
     await page.realClick("#detector")
-    await page.waitForSelector("#isBot span", { timeout: 20000 });
     let result = await page.evaluate(() => { return document.querySelector('#isBot span').textContent.includes("not") ? true : false })
     assert.strictEqual(result, true, "DrissionPage Detector test failed!")
 })

package/typings.d.ts

@@ -31,8 +31,6 @@ declare module "real-browser-mcp-server" {
 		enableBlocker?: boolean;
 		/** Blocker configuration options */
 		blockerOptions?: BlockerOptions;
-		/** Enable visual cursor arrow overlay (defaults to true in headed/visible mode, false in headless mode) */
-		visualCursor?: boolean;
 	}
 
 	interface ProxyOptions {