brave-real-browser-mcp-server 2.9.9 → 2.9.11

package/README.md

@@ -43,6 +43,46 @@ If you're just using this MCP server (not developing it), you don't need to run
 - Download and install Node.js (version 18 or higher)
 - Verify installation by opening terminal/command prompt and typing: `node --version`
 
+## Installation for Developers
+
+> **Note for Claude Desktop Users:** You don't need to install anything! The npx command in your configuration automatically handles everything. Skip to the [Usage](#usage) section.
+
+This section is for developers who want to:
+- Contribute to the project
+- Run the server locally for development
+- Create custom modifications
+
+### Global Installation (For Command Line Usage)
+
+If you want to run the server directly from the command line without using npx:
+
+```bash
+npm install -g brave-real-browser-mcp-server@latest
+```
+
+After global installation, you can run:
+```bash
+brave-real-browser-mcp-server
+```
+
+### Development Setup (For Contributors)
+
+```bash
+# Clone the repository
+git clone https://github.com/withLinda/brave-real-browser-mcp-server.git
+cd brave-real-browser-mcp-server
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run in development mode
+npm run dev
+```
+
+
 #### 2. Configure Claude Desktop
 
 **For Windows:**
@@ -68,7 +108,7 @@ If you're just using this MCP server (not developing it), you don't need to run
       "command": "npx",
       "args": ["brave-real-browser-mcp-server@latest"],
       "env": {
-        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
       }
     }
   }
@@ -207,44 +247,6 @@ This project **exclusively uses Brave Browser** and is specifically optimized fo
   - Detected paths: `/usr/bin/brave-browser`, `/snap/bin/brave`, `/usr/bin/brave`, `/opt/brave.com/brave/brave-browser`
 - Install xvfb for headless operation: `sudo apt-get install -y xvfb`
 
-## Installation for Developers
-
-> **Note for Claude Desktop Users:** You don't need to install anything! The npx command in your configuration automatically handles everything. Skip to the [Usage](#usage) section.
-
-This section is for developers who want to:
-- Contribute to the project
-- Run the server locally for development
-- Create custom modifications
-
-### Global Installation (For Command Line Usage)
-
-If you want to run the server directly from the command line without using npx:
-
-```bash
-npm install -g brave-real-browser-mcp-server@latest
-```
-
-After global installation, you can run:
-```bash
-brave-real-browser-mcp-server
-```
-
-### Development Setup (For Contributors)
-
-```bash
-# Clone the repository
-git clone https://github.com/withLinda/brave-real-browser-mcp-server.git
-cd brave-real-browser-mcp-server
-
-# Install dependencies
-npm install
-
-# Build the project
-npm run build
-
-# Run in development mode
-npm run dev
-```
 
 ## Usage
 

package/dist/browser-manager.js

@@ -233,7 +233,7 @@ function getWindowsBraveFromRegistry() {
                     ];
                     for (const bravePath of bravePaths) {
                         if (fs.existsSync(bravePath)) {
-                            console.error(`✓ Found Brave via Registry detection: ${bravePath}`);
+                            console.log(`✅ Found Brave via Registry detection: ${bravePath}`);
                             return bravePath;
                         }
                     }
@@ -249,7 +249,7 @@ function getWindowsBraveFromRegistry() {
             const result = execSync(installDirQuery, { encoding: 'utf8', timeout: 5000 });
             const match = result.match(/REG_SZ\s+(.+\.exe)/);
             if (match && match[1] && fs.existsSync(match[1])) {
-                console.error(`✓ Found Brave via App Paths registry: ${match[1]}`);
+                console.log(`✅ Found Brave via App Paths registry: ${match[1]}`);
                 return match[1];
             }
         }
@@ -271,7 +271,7 @@ export function detectBravePath() {
         try {
             const bravePath = braveLauncher.getBravePath();
             if (bravePath && fs.existsSync(bravePath)) {
-                console.error(`✅ Found Brave via brave-real-launcher (professional detection): ${bravePath}`);
+                console.log(`✅ Found Brave via brave-real-launcher (professional detection): ${bravePath}`);
                 return bravePath;
             }
         }
@@ -285,7 +285,7 @@ export function detectBravePath() {
         if (fs.existsSync(configPath)) {
             const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
             if (config.bravePath && fs.existsSync(config.bravePath)) {
-                console.error(`✓ Found Brave via .brave-config.json (auto-detected): ${config.bravePath}`);
+                console.log(`✅ Found Brave via .brave-config.json (auto-detected): ${config.bravePath}`);
                 return config.bravePath;
             }
         }
@@ -296,7 +296,7 @@ export function detectBravePath() {
     // PRIORITY 1: Check environment variables first (BRAVE_PATH only)
     const envBravePath = process.env.BRAVE_PATH;
     if (envBravePath && fs.existsSync(envBravePath)) {
-        console.error(`✓ Found Brave via BRAVE_PATH environment variable: ${envBravePath}`);
+        console.log(`✅ Found Brave via BRAVE_PATH environment variable: ${envBravePath}`);
         return envBravePath;
     }
     // PRIORITY 2: Brave paths detection (Brave-only project!)
@@ -354,8 +354,8 @@ export function detectBravePath() {
         try {
             console.error(`   Checking: ${bravePath}`);
             if (fs.existsSync(bravePath)) {
-                console.error(`✅ Found Brave Browser at: ${bravePath}`);
-                console.error('   🎯 Perfect! Using Brave Browser (optimized for this project)');
+                console.log(`✅ Found Brave Browser at: ${bravePath}`);
+                console.log('   🎯 Perfect! Using Brave Browser (optimized for this project)');
                 return bravePath;
             }
         }
@@ -598,14 +598,14 @@ export async function initializeBrowser(options) {
         if (options?.plugins && Array.isArray(options.plugins)) {
             connectOptions.plugins = options.plugins;
         }
-        console.error('🔍 Testing network connectivity...');
+        console.log('🔍 Testing network connectivity...');
         const hostTest = await testHostConnectivity();
-        console.error(`   localhost available: ${hostTest.localhost}`);
-        console.error(`   127.0.0.1 available: ${hostTest.ipv4}`);
-        console.error(`   recommended host: ${hostTest.recommendedHost}`);
+        console.log(`   localhost available: ${hostTest.localhost}`);
+        console.log(`   127.0.0.1 available: ${hostTest.ipv4}`);
+        console.log(`   recommended host: ${hostTest.recommendedHost}`);
         const availablePort = await findAvailablePort();
         if (availablePort) {
-            console.error(`🔍 Found available debugging port: ${availablePort}`);
+            console.log(`🔍 Found available debugging port: ${availablePort}`);
         }
         else {
             console.error('⚠️  No available ports found in range 9222-9322, using system-assigned port');
@@ -691,17 +691,17 @@ export async function initializeBrowser(options) {
         for (let strategyIndex = 0; strategyIndex < connectionStrategies.length; strategyIndex++) {
             const { strategyName, strategy } = connectionStrategies[strategyIndex];
             try {
-                console.error(`🔄 Attempting browser connection using ${strategyName}...`);
+                console.log(`🔄 Attempting browser connection using ${strategyName}...`);
                 const result = await withTimeout(async () => {
                     try {
-                        console.error(`   Strategy config: ${JSON.stringify({
+                        console.log(`   Strategy config: ${JSON.stringify({
                             headless: strategy.headless,
                             ignoreAllFlags: strategy.ignoreAllFlags,
                             chromeFlags: strategy.customConfig?.chromeFlags || 'none',
                             chromePath: strategy.customConfig?.chromePath || 'default'
                         })}`);
                         const connectResult = await connect(strategy);
-                        console.error(`   ✅ Connection successful with ${strategyName}`);
+                        console.log(`   ✅ Connection successful with ${strategyName}`);
                         return connectResult;
                     }
                     catch (connectionError) {
@@ -729,7 +729,7 @@ export async function initializeBrowser(options) {
                 const { browser, page } = result;
                 browserInstance = browser;
                 pageInstance = page;
-                console.error(`✅ Browser initialized successfully using ${strategyName}`);
+                console.log(`✅ Browser initialized successfully using ${strategyName}`);
                 updateCircuitBreakerOnSuccess();
                 // Resolve the init promise to unblock waiting calls
                 if (resolveInit) {
@@ -862,7 +862,7 @@ export async function closeBrowser() {
             browserInitDepth = 0;
             browserInitializationInProgress = false; // Also reset initialization flag
             browserInitPromise = null; // Clear promise lock
-            console.error('🔄 Browser closed, browserInitDepth and initialization flag reset');
+            console.log('🔄 Browser closed, browserInitDepth and initialization flag reset');
         }
     }
 }

package/dist/handlers/browser-handlers.js

@@ -49,7 +49,7 @@ export async function handleBrowserClose() {
     });
 }
 // Workflow validation wrapper
-async function withWorkflowValidation(toolName, args, operation) {
+export async function withWorkflowValidation(toolName, args, operation) {
     // Validate workflow state before execution
     const validation = validateWorkflow(toolName, args);
     // Defensive check: if validation is undefined or null, allow execution (test environment)

package/dist/handlers/content-handlers.js

@@ -40,7 +40,7 @@ export async function handleGetContent(args) {
             const tokenCount = tokenManager.countTokens(processedContent);
             const maxTokens = 20000; // Safe default for MCP
             if (tokenCount > maxTokens) {
-                console.warn(`Content size (${tokenCount} tokens) exceeds limit (${maxTokens} tokens). Chunking content...`);
+                console.log(`Content size (${tokenCount} tokens) exceeds limit (${maxTokens} tokens). Chunking content...`);
                 const chunks = [processedContent.substring(0, Math.floor(maxTokens * 0.8 * 3))];
                 const firstChunk = chunks[0];
                 return {

package/dist/handlers/navigation-handlers.js

@@ -10,7 +10,7 @@ export async function handleNavigate(args) {
                 throw new Error('Browser not initialized. Call browser_init first.');
             }
             const { url, waitUntil = 'domcontentloaded' } = args;
-            console.error(`🔄 Navigating to: ${url}`);
+            console.log(`🔄 Navigating to: ${url}`);
             // Navigate with retry logic
             let lastError = null;
             let success = false;
@@ -23,7 +23,7 @@ export async function handleNavigate(args) {
                             timeout: 60000
                         });
                     }, 60000, 'page-navigation');
-                    console.error(`✅ Navigation successful to: ${url}`);
+                    console.log(`✅ Navigation successful to: ${url}`);
                     success = true;
                     break;
                 }