brave-real-browser-mcp-server 1.5.16 → 2.0.3

package/README.md

@@ -3,7 +3,7 @@
 
 # Brave Real Browser MCP Server
 
-Provides AI assistants with powerful, detection-resistant browser automation capabilities built on ZFC Digital's puppeteer-real-browser package.
+Provides AI assistants with powerful, detection-resistant browser automation capabilities built on ZFC Digital's brave-real-browser package.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -103,8 +103,8 @@ Once set up, you can ask Claude to:
 
 ## Introduction
 
-The Puppeteer Real Browser MCP Server acts as a bridge between AI assistants
-and browser automation. It leverages puppeteer-real-browser to provide stealth
+The Brave Real Browser MCP Server acts as a bridge between AI assistants
+and browser automation. It leverages brave-real-browser to provide stealth
 browsing capabilities that can bypass common bot detection mechanisms.
 
 This server implements the Model Context Protocol (MCP), allowing AI
@@ -117,7 +117,7 @@ assistants to control a real browser, extract content, and more.
 - **Smart Chrome detection**: Registry-based detection + 15+ installation paths (Windows)
 - **Connection resilience**: Automatic localhost/127.0.0.1 fallback with port management
 - **Multiple retry strategies**: 5 different connection approaches with progressive fallback
-- **Advanced configuration**: Full support for all puppeteer-real-browser options
+- **Advanced configuration**: Full support for all brave-real-browser options
 - **Dynamic selector discovery**: Intelligent element finding without hardcoded selectors
 - **Random scrolling**: Tools for natural scrolling to avoid detection
 - **Comprehensive toolset**: 11 tools covering all browser automation needs
@@ -213,7 +213,7 @@ The configuration below uses `npx` to automatically download and run the latest
 
 ### With Claude Code CLI
 
-Claude Code CLI offers multiple convenient methods to add the puppeteer-real-browser MCP server. Choose the method that best fits your workflow:
+Claude Code CLI offers multiple convenient methods to add the brave-real-browser MCP server. Choose the method that best fits your workflow:
 
 #### Method 1: Quick Setup (Recommended)
 
@@ -581,7 +581,7 @@ The server includes basic support for solving common captcha types:
 - Cloudflare Turnstile
 
 Note that captcha solving capabilities depend on the underlying
-puppeteer-real-browser implementation.
+brave-real-browser implementation.
 
 ## Configuration
 
@@ -881,7 +881,7 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    
    - **MCP Server Status**:
      - Use `/mcp` command in Claude Code to check server status
-     - Look for the "puppeteer-real-browser" server in the list
+     - Look for the "brave-real-browser" server in the list
      - Check if server status shows "connected" or error messages
    
    - **Environment Variables**:
@@ -1003,10 +1003,10 @@ A: Yes, set `headless: true` in browser_init options.
 A: Currently supports one browser instance. Close the current one before starting a new one.
 
 **Q: What captchas can it solve?**
-A: Supports reCAPTCHA, hCaptcha, and Cloudflare Turnstile through puppeteer-real-browser.
+A: Supports reCAPTCHA, hCaptcha, and Cloudflare Turnstile through brave-real-browser.
 
 **Q: Is this detectable by websites?**
-A: puppeteer-real-browser includes anti-detection features, but no solution is 100% undetectable.
+A: brave-real-browser includes anti-detection features, but no solution is 100% undetectable.
 
 **Q: Can I use custom Chrome extensions?**
 A: Yes, through the `plugins` option in browser_init.
@@ -1075,7 +1075,7 @@ DEBUG=true npm run dev
 ### Getting Help
 
 If you're still having issues:
-1. Check the [GitHub Issues](https://github.com/withLinda/brave-real-browser-mcp-server/issues)
+1. Check the [GitHub Issues](https://github.com/your-organization/brave-real-browser-mcp-server/issues)
 2. Create a new issue with:
    - Your operating system
    - Node.js version (`node --version`)
@@ -1197,9 +1197,9 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Acknowledgments
 
-This MCP server is based on the excellent [puppeteer-real-browser](https://github.com/ZFC-Digital/puppeteer-real-browser) library by ZFC-Digital.
+This MCP server is based on the excellent [brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser) library by ZFC-Digital.
 
-**Thank you** to the puppeteer-real-browser team for creating such a powerful and detection-resistant browser automation solution!
+**Thank you** to the brave-real-browser team for creating such a powerful and detection-resistant browser automation solution!
 
-- GitHub: [https://github.com/ZFC-Digital/puppeteer-real-browser](https://github.com/ZFC-Digital/puppeteer-real-browser)
-- npm: [https://www.npmjs.com/package/puppeteer-real-browser](https://www.npmjs.com/package/puppeteer-real-browser)
+- GitHub: [https://github.com/ZFC-Digital/brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser)
+- npm: [https://www.npmjs.com/package/brave-real-browser](https://www.npmjs.com/package/brave-real-browser)

package/dist/browser-manager.js

@@ -1,4 +1,4 @@
-import { connect } from 'puppeteer-real-browser';
+import { connect } from 'brave-real-browser';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as net from 'net';

package/dist/browser-manager.test.js

@@ -15,7 +15,7 @@ import { BrowserErrorType, categorizeError, withTimeout, isPortAvailable, testHo
 vi.mock('fs');
 vi.mock('net');
 vi.mock('child_process');
-vi.mock('puppeteer-real-browser', () => ({
+vi.mock('brave-real-browser', () => ({
     connect: vi.fn()
 }));
 describe('Browser Manager', () => {

package/dist/index.js

@@ -189,9 +189,9 @@ console.error(`🔍 [DEBUG] process.argv[1]: ${process.argv[1]}`);
 console.error(`🔍 [DEBUG] process.argv[0]: ${process.argv[0]}`);
 // Enhanced main module detection for npx compatibility
 const isMain = import.meta.url === `file://${process.argv[1]}` ||
-    process.argv[1].includes('brave-real-browser-mcp-server') ||
-    process.argv[1].endsWith('.bin/brave-real-browser-mcp-server') ||
-    process.argv.some(arg => arg.includes('brave-real-browser-mcp-server'));
+    (process.argv[1] && process.argv[1].includes('brave-real-browser-mcp-server')) ||
+    (process.argv[1] && process.argv[1].endsWith('.bin/brave-real-browser-mcp-server')) ||
+    process.argv.some(arg => arg && arg.includes('brave-real-browser-mcp-server'));
 console.error(`🔍 [DEBUG] Enhanced main detection result: ${isMain}`);
 if (isMain) {
     console.error('🔍 [DEBUG] Module is main - starting server...');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "1.5.16",
+  "version": "2.0.3",
   "description": "MCP server for brave-real-browser",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,9 @@
     "fix-cache-permissions": "echo 'Run: sudo chown -R $(whoami):$(id -gn) ~/.npm' && echo 'This fixes npm cache permission issues'",
     "clean:modules": "rm -rf node_modules",
     "clean:all": "npm run clean:modules && npm run clean:cache && npm run clean",
-    "fresh-install": "npm run clean:all && npm install",
+    "update-brave-packages": "npm install brave-real-browser@latest brave-real-launcher@latest brave-real-puppeteer-core@latest --save --force",
+    "ensure-latest-packages": "node scripts/ensure-latest-packages.js",
+    "fresh-install": "npm run clean:all && npm install && npm run ensure-latest-packages",
     "fresh-start": "npm run fresh-install && npm run build && npm start",
     "fresh-dev": "npm run fresh-install && npm run build && npm run dev",
     "prebuild": "npm run clean",
@@ -32,12 +34,19 @@
     "test:performance": "node tests/performance/performance-tests.js",
     "test:debug": "node debug-server.js",
     "test:all": "npm run test:ci && npm run test:full && npm run test:performance",
-    "test:dashboard": "node test-runner.js"
+    "test:dashboard": "node test-runner.js",
+    "test:nopecha": "node test.cjs",
+    "test:comprehensive": "node test.cjs",
+    "test:version-increment": "node scripts/test-version-increment.cjs",
+    "test:workflow": "node scripts/test-workflow-local.cjs",
+    "test:workflow:full": "npm run test:workflow && npm run test:version-increment"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": ">=1.0.0",
     "@types/turndown": "^5.0.5",
-    "puppeteer-real-browser": "^1.3.18",
+    "brave-real-browser": "^1.5.95",
+    "brave-real-launcher": "^1.2.10",
+    "brave-real-puppeteer-core": "^24.22.0",
     "turndown": "^7.2.0"
   },
   "peerDependencies": {
@@ -45,12 +54,12 @@
   },
   "devDependencies": {
     "@types/node": "latest",
-    "@vitest/coverage-v8": "^2.1.8",
-    "@vitest/ui": "^2.1.8",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
     "rimraf": "^6.0.1",
     "tsx": "latest",
     "typescript": "^5.5.3",
-    "vitest": "^2.1.8"
+    "vitest": "^3.2.4"
   },
   "keywords": [
     "mcp",