real-browser-mcp-server 1.1.1 → 1.3.0

package/lib/cjs/index.js

@@ -181,7 +181,22 @@ async function connect({
   headless = getDefaultHeadless(),
   proxy = {},
   turnstile = false,
+  disableXvfb = false,
 } = {}) {
+  let xvfbInstance = null;
+  if (process.platform === 'linux' && !process.env.DISPLAY && !disableXvfb) {
+    try {
+      const Xvfb = require('xvfb');
+      xvfbInstance = new Xvfb({
+        silent: true,
+        xvfb_args: ['-screen', '0', '1280x1024x24', '-ac']
+      });
+      xvfbInstance.startSync();
+    } catch (err) {
+      console.error('[xvfb] Failed to start Xvfb server automatically:', err.message);
+    }
+  }
+
   let playwrightProxy = undefined;
   if (proxy && proxy.host && proxy.port) {
     playwrightProxy = {
@@ -212,6 +227,25 @@ async function connect({
     plugins: [recommended()]
   });
 
+  if (xvfbInstance) {
+    browser.on('disconnected', () => {
+      try {
+        xvfbInstance.stopSync();
+      } catch (e) {
+        console.error('[xvfb] Failed to stop Xvfb server:', e.message);
+      }
+    });
+    const originalClose = browser.close.bind(browser);
+    browser.close = async () => {
+      await originalClose();
+      try {
+        xvfbInstance.stopSync();
+      } catch (e) {
+        console.error('[xvfb] Failed to stop Xvfb server during close:', e.message);
+      }
+    };
+  }
+
   // Ensure ad blocker is ready
   await getAdBlocker();
 

package/lib/esm/index.mjs

@@ -4,6 +4,7 @@ const { chromium } = playwright;
 import { PlaywrightBlocker } from "@ghostery/adblocker-playwright";
 import { pageController } from "./module/pageController.mjs";
 import { fileURLToPath } from 'url';
+import Xvfb from "xvfb";
 import * as fs from 'fs';
 import * as path from 'path';
 
@@ -184,7 +185,21 @@ export async function connect({
   headless = getDefaultHeadless(),
   proxy = {},
   turnstile = false,
+  disableXvfb = false,
 } = {}) {
+  let xvfbInstance = null;
+  if (process.platform === 'linux' && !process.env.DISPLAY && !disableXvfb) {
+    try {
+      xvfbInstance = new Xvfb({
+        silent: true,
+        xvfb_args: ['-screen', '0', '1280x1024x24', '-ac']
+      });
+      xvfbInstance.startSync();
+    } catch (err) {
+      console.error('[xvfb] Failed to start Xvfb server automatically:', err.message);
+    }
+  }
+
   let playwrightProxy = undefined;
   if (proxy && proxy.host && proxy.port) {
     playwrightProxy = {
@@ -210,6 +225,25 @@ export async function connect({
     plugins: [recommended()]
   });
 
+  if (xvfbInstance) {
+    browser.on('disconnected', () => {
+      try {
+        xvfbInstance.stopSync();
+      } catch (e) {
+        console.error('[xvfb] Failed to stop Xvfb server:', e.message);
+      }
+    });
+    const originalClose = browser.close.bind(browser);
+    browser.close = async () => {
+      await originalClose();
+      try {
+        xvfbInstance.stopSync();
+      } catch (e) {
+        console.error('[xvfb] Failed to stop Xvfb server during close:', e.message);
+      }
+    };
+  }
+
   // Ensure ad blocker is ready
   await getAdBlocker();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "real-browser-mcp-server",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "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",
@@ -28,7 +28,8 @@
     "test": "npm run cjs_test && npm run esm_test",
     "esm_test": "node ./test/esm/test.js",
     "cjs_test": "node ./test/cjs/test.js",
-    "build": "echo 'No build step required for this package.'"
+    "build": "echo 'No build step required for this package.'",
+    "postinstall": "npx patchright install chromium"
   },
   "keywords": [
     "mcp-server",
@@ -45,6 +46,7 @@
     "@ghostery/adblocker-playwright": "latest",
     "@modelcontextprotocol/sdk": "latest",
     "patchright": "latest",
-    "playwright-ghost": "latest"
+    "playwright-ghost": "^0.18.0",
+    "xvfb": "^0.4.0"
   }
 }