brave-real-browser-mcp-server 2.12.6 → 2.12.8

package/dist/index.js

@@ -111,11 +111,8 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => {
     console.error("🔍 [DEBUG] Prompts list requested");
     return { prompts: [] };
 });
-// Main tool call handler
-console.error("🔍 [DEBUG] Registering tool call handler...");
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    console.error(`🔍 [DEBUG] Tool call received: ${name} with args: ${JSON.stringify(args)}`);
+// Tool execution function - exported for use in transports
+export async function executeToolByName(name, args) {
     try {
         let result;
         switch (name) {
@@ -492,6 +489,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             isError: true,
         };
     }
+}
+// Main tool call handler
+console.error("🔍 [DEBUG] Registering tool call handler...");
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    console.error(`🔍 [DEBUG] Tool call received: ${name} with args: ${JSON.stringify(args)}`);
+    return await executeToolByName(name, args);
 });
 // Main function - now using multi-protocol launcher
 import { main as launcherMain } from "./launcher.js";

package/dist/transports/http-transport.js

@@ -1,13 +1,13 @@
 import express from 'express';
 import { createServer } from 'http';
 import { WebSocketServer } from 'ws';
-import { TOOLS, TOOL_NAMES } from '../tool-definitions.js';
-// Import all handlers
+import { TOOLS } from '../tool-definitions.js';
+import { executeToolByName } from '../index.js';
+// Import specific handlers for direct endpoints (for backward compatibility)
 import { handleBrowserInit, handleBrowserClose } from '../handlers/browser-handlers.js';
-import { handleNavigate, handleWait } from '../handlers/navigation-handlers.js';
-import { handleClick, handleType, handleSolveCaptcha, handleRandomScroll } from '../handlers/interaction-handlers.js';
-import { handleGetContent, handleFindSelector } from '../handlers/content-handlers.js';
-import { handleSaveContentAsMarkdown } from '../handlers/file-handlers.js';
+import { handleNavigate } from '../handlers/navigation-handlers.js';
+import { handleClick, handleType } from '../handlers/interaction-handlers.js';
+import { handleGetContent } from '../handlers/content-handlers.js';
 export class HttpTransport {
     app;
     server = null;
@@ -128,32 +128,8 @@ export class HttpTransport {
         });
     }
     async executeTool(toolName, args) {
-        switch (toolName) {
-            case TOOL_NAMES.BROWSER_INIT:
-                return await handleBrowserInit(args || {});
-            case TOOL_NAMES.NAVIGATE:
-                return await handleNavigate(args);
-            case TOOL_NAMES.GET_CONTENT:
-                return await handleGetContent(args || {});
-            case TOOL_NAMES.CLICK:
-                return await handleClick(args);
-            case TOOL_NAMES.TYPE:
-                return await handleType(args);
-            case TOOL_NAMES.WAIT:
-                return await handleWait(args);
-            case TOOL_NAMES.BROWSER_CLOSE:
-                return await handleBrowserClose();
-            case TOOL_NAMES.SOLVE_CAPTCHA:
-                return await handleSolveCaptcha(args);
-            case TOOL_NAMES.RANDOM_SCROLL:
-                return await handleRandomScroll();
-            case TOOL_NAMES.FIND_SELECTOR:
-                return await handleFindSelector(args);
-            case TOOL_NAMES.SAVE_CONTENT_AS_MARKDOWN:
-                return await handleSaveContentAsMarkdown(args);
-            default:
-                throw new Error(`Unknown tool: ${toolName}`);
-        }
+        // Use universal tool executor from index.ts (supports all 110 tools)
+        return await executeToolByName(toolName, args);
     }
     setupWebSocket() {
         if (!this.server || !this.config.enableWebSocket)

package/dist/transports/sse-transport.js

@@ -1,12 +1,12 @@
 import express from 'express';
 import { createServer } from 'http';
-import { TOOLS, TOOL_NAMES } from '../tool-definitions.js';
-// Import all handlers
+import { TOOLS } from '../tool-definitions.js';
+import { executeToolByName } from '../index.js';
+// Import specific handlers for direct endpoints (for backward compatibility)
 import { handleBrowserInit, handleBrowserClose } from '../handlers/browser-handlers.js';
-import { handleNavigate, handleWait } from '../handlers/navigation-handlers.js';
-import { handleClick, handleType, handleSolveCaptcha, handleRandomScroll } from '../handlers/interaction-handlers.js';
-import { handleGetContent, handleFindSelector } from '../handlers/content-handlers.js';
-import { handleSaveContentAsMarkdown } from '../handlers/file-handlers.js';
+import { handleNavigate } from '../handlers/navigation-handlers.js';
+import { handleClick, handleType } from '../handlers/interaction-handlers.js';
+import { handleGetContent } from '../handlers/content-handlers.js';
 export class SseTransport {
     app;
     server = null;
@@ -207,32 +207,8 @@ export class SseTransport {
         });
     }
     async executeTool(toolName, args) {
-        switch (toolName) {
-            case TOOL_NAMES.BROWSER_INIT:
-                return await handleBrowserInit(args || {});
-            case TOOL_NAMES.NAVIGATE:
-                return await handleNavigate(args);
-            case TOOL_NAMES.GET_CONTENT:
-                return await handleGetContent(args || {});
-            case TOOL_NAMES.CLICK:
-                return await handleClick(args);
-            case TOOL_NAMES.TYPE:
-                return await handleType(args);
-            case TOOL_NAMES.WAIT:
-                return await handleWait(args);
-            case TOOL_NAMES.BROWSER_CLOSE:
-                return await handleBrowserClose();
-            case TOOL_NAMES.SOLVE_CAPTCHA:
-                return await handleSolveCaptcha(args);
-            case TOOL_NAMES.RANDOM_SCROLL:
-                return await handleRandomScroll();
-            case TOOL_NAMES.FIND_SELECTOR:
-                return await handleFindSelector(args);
-            case TOOL_NAMES.SAVE_CONTENT_AS_MARKDOWN:
-                return await handleSaveContentAsMarkdown(args);
-            default:
-                throw new Error(`Unknown tool: ${toolName}`);
-        }
+        // Use universal tool executor from index.ts (supports all 110 tools)
+        return await executeToolByName(toolName, args);
     }
     sendEvent(res, eventType, data) {
         const eventData = `event: ${eventType}\ndata: ${JSON.stringify(data)}\n\n`;

package/dist/transports/sse-transport.test.js

@@ -111,9 +111,11 @@ describe('SSE Transport', () => {
                 body: JSON.stringify({}),
             });
             const data = await response.json();
-            expect(response.status).toBe(500);
-            expect(data.success).toBe(false);
-            expect(data.error).toContain('Unknown tool');
+            // MCP format: errors are returned in content with isError flag
+            expect(response.status).toBe(200);
+            expect(data.success).toBe(true);
+            expect(data.result.isError).toBe(true);
+            expect(data.result.content[0].text).toContain('Unknown tool');
         });
         it('should validate tool arguments', async () => {
             const response = await fetch(`http://${TEST_HOST}:${TEST_PORT}/tools/navigate`, {
@@ -124,8 +126,10 @@ describe('SSE Transport', () => {
                 body: JSON.stringify({ /* missing url */}),
             });
             const data = await response.json();
-            expect(response.status).toBe(500);
-            expect(data.success).toBe(false);
+            // MCP format: validation errors are returned with success=true but result.isError=true
+            expect(response.status).toBe(200);
+            expect(data.success).toBe(true);
+            expect(data.result.isError).toBe(true);
         });
     });
     describe('CORS Headers', () => {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.12.6",
+  "version": "2.12.8",
   "description": "Universal AI IDE MCP Server - Auto-detects and supports all AI IDEs (Claude Desktop, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.) with Brave browser automation",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {
-    "postinstall": "node scripts/update-to-latest.cjs || echo 'Auto-update skipped'",
+    "postinstall": "node scripts/patch-puppeteer-screen-recorder.cjs && node scripts/update-to-latest.cjs || echo 'Auto-update skipped'",
     "clean": "rimraf dist",
     "clean:cache": "npm cache clean --force",
     "fix-cache-permissions": "echo 'Run: sudo chown -R $(whoami):$(id -gn) ~/.npm' && echo 'This fixes npm cache permission issues'",
@@ -42,7 +42,7 @@
     "axios": "^1.6.5",
     "brave-real-browser": "^1.5.102",
     "brave-real-launcher": "^1.2.18",
-    "brave-real-puppeteer-core": "^24.25.0",
+    "brave-real-puppeteer-core": "^24.26.1",
     "cheerio": "^1.0.0-rc.12",
     "chrono-node": "^2.7.0",
     "compromise": "^14.13.0",
@@ -53,10 +53,10 @@
     "natural": "^6.12.0",
     "pixelmatch": "^5.3.0",
     "pngjs": "^7.0.0",
-    "puppeteer-screen-recorder": "^3.0.5",
+    "puppeteer-screen-recorder": "^3.0.6",
     "sentiment": "^5.0.2",
     "tesseract.js": "^5.0.5",
-    "turndown": "^7.2.1",
+    "turndown": "^7.2.2",
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.12",
     "ws": "^8.18.3",
@@ -117,6 +117,8 @@
   },
   "files": [
     "dist/**/*",
+    "scripts/**/*",
+    ".npmrc",
     "README.md",
     "LICENSE"
   ],
@@ -132,7 +134,13 @@
   "overrides": {
     "puppeteer": "npm:brave-real-puppeteer-core@latest",
     "puppeteer-core": "npm:brave-real-puppeteer-core@latest",
-    "tar-fs": "^3.0.0",
-    "ws": "^8.18.3"
+    "puppeteer-screen-recorder": {
+      "puppeteer": "npm:brave-real-puppeteer-core@latest",
+      "fluent-ffmpeg": "latest"
+    },
+    "fluent-ffmpeg": "latest",
+    "glob": "latest",
+    "inflight": "latest",
+    "tar-fs": "latest"
   }
 }

package/scripts/patch-puppeteer-screen-recorder.cjs

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+/**
+ * Patch script for puppeteer-screen-recorder
+ * 
+ * This script patches the peerDependencies in puppeteer-screen-recorder's package.json
+ * to use brave-real-puppeteer-core instead of the old puppeteer@19.0.0
+ * 
+ * Runs automatically after npm install via postinstall hook
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Path to puppeteer-screen-recorder's package.json
+const packagePath = path.join(
+  process.cwd(),
+  'node_modules',
+  'puppeteer-screen-recorder',
+  'package.json'
+);
+
+// Skip if package doesn't exist
+if (!fs.existsSync(packagePath)) {
+  console.log('ℹ️  puppeteer-screen-recorder not found, skipping patch');
+  process.exit(0);
+}
+
+try {
+  console.log('🔧 Patching puppeteer-screen-recorder peerDependencies...');
+  
+  // Read the package.json
+  const packageJson = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+  
+  // Check if patch is needed
+  if (packageJson.peerDependencies && packageJson.peerDependencies.puppeteer) {
+    const currentValue = packageJson.peerDependencies.puppeteer;
+    
+    // Only patch if it's the old version
+    if (currentValue === '19.0.0' || !currentValue.includes('brave-real-puppeteer-core')) {
+      // Update to brave-real-puppeteer-core
+      packageJson.peerDependencies.puppeteer = 'npm:brave-real-puppeteer-core@>=24.0.0';
+      
+      // Write back to file
+      fs.writeFileSync(packagePath, JSON.stringify(packageJson, null, 2), 'utf8');
+      
+      console.log('   ✓ puppeteer-screen-recorder patched successfully');
+      console.log('   ✓ peerDependencies.puppeteer: npm:brave-real-puppeteer-core@>=24.0.0');
+    } else {
+      console.log('   ✓ puppeteer-screen-recorder already patched');
+    }
+  } else {
+    console.log('   ⚠️  No puppeteer peerDependency found');
+  }
+  
+} catch (error) {
+  console.error('⚠️  Failed to patch puppeteer-screen-recorder:', error.message);
+  console.log('ℹ️  Continuing anyway...');
+  process.exit(0); // Don't fail the install
+}

package/scripts/update-to-latest.cjs

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+
+/**
+ * Auto-update script for brave-real-browser-mcp-server
+ * 
+ * This script automatically updates all dependencies to their latest versions
+ * when npm install is run. It ensures the project always uses the most recent
+ * compatible versions while maintaining all functionality.
+ * 
+ * Features:
+ * - Updates brave-real-browser to latest
+ * - Updates @modelcontextprotocol/sdk to latest
+ * - Skips in CI environments to prevent infinite loops
+ * - Silent mode to avoid cluttering install output
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Skip in CI environments to prevent recursive installs
+const isCIEnvironment = process.env.CI === 'true' || 
+                        process.env.GITHUB_ACTIONS === 'true' ||
+                        process.env.SKIP_AUTO_UPDATE === 'true';
+
+if (isCIEnvironment) {
+  console.log('ℹ️  Auto-update skipped in CI environment');
+  process.exit(0);
+}
+
+// Check if we're in the root of the package
+const packageJsonPath = path.join(process.cwd(), 'package.json');
+if (!fs.existsSync(packageJsonPath)) {
+  console.log('ℹ️  Not in package root, skipping auto-update');
+  process.exit(0);
+}
+
+console.log('\n🔄 Auto-updating dependencies to latest versions...\n');
+
+// List of packages to always keep at latest version
+const packagesToUpdate = [
+  'brave-real-browser',
+  'brave-real-launcher',
+  'brave-real-puppeteer-core',
+  '@modelcontextprotocol/sdk',
+  'turndown',
+  '@types/turndown',
+  'puppeteer-screen-recorder',
+  'rimraf'
+];
+
+try {
+  // Update each package to latest
+  for (const pkg of packagesToUpdate) {
+    try {
+      console.log(`   Updating ${pkg}...`);
+      execSync(`npm install ${pkg}@latest --save --no-audit --no-fund`, {
+        stdio: 'pipe',
+        cwd: process.cwd()
+      });
+      console.log(`   ✓ ${pkg} updated to latest`);
+    } catch (error) {
+      console.log(`   ⚠️  Could not update ${pkg} (non-critical)`);
+    }
+  }
+
+  console.log('\n✅ All dependencies updated to latest versions!\n');
+  
+  // Show current versions
+  console.log('📦 Current versions:');
+  for (const pkg of packagesToUpdate) {
+    try {
+      const version = execSync(`npm list ${pkg} --depth=0 --json`, {
+        stdio: 'pipe',
+        encoding: 'utf8'
+      });
+      const parsed = JSON.parse(version);
+      const installedVersion = parsed.dependencies?.[pkg]?.version || 'not found';
+      console.log(`   ${pkg}: ${installedVersion}`);
+    } catch (error) {
+      // Ignore errors
+    }
+  }
+  
+  // Step 4: Run npm audit fix to resolve security vulnerabilities
+  console.log('\n🔒 Running security audit fix...');
+  try {
+    execSync('npm audit fix --force', {
+      stdio: 'pipe',
+      cwd: process.cwd()
+    });
+    console.log('   ✓ Security vulnerabilities fixed');
+  } catch (error) {
+    // Check if there are still vulnerabilities
+    try {
+      const auditResult = execSync('npm audit --json', {
+        stdio: 'pipe',
+        encoding: 'utf8'
+      });
+      const audit = JSON.parse(auditResult);
+      if (audit.metadata && audit.metadata.vulnerabilities) {
+        const total = audit.metadata.vulnerabilities.total || 0;
+        if (total === 0) {
+          console.log('   ✓ No security vulnerabilities found');
+        } else {
+          console.log(`   ⚠️  ${total} vulnerabilities remaining (may require manual review)`);
+        }
+      }
+    } catch (auditError) {
+      console.log('   ℹ️  Security audit completed');
+    }
+  }
+  
+  console.log('');
+
+} catch (error) {
+  console.error('⚠️  Auto-update encountered an error:', error.message);
+  console.log('ℹ️  Continuing with current versions...\n');
+  process.exit(0); // Don't fail the install
+}