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

package/README.md

@@ -189,282 +189,6 @@ npx brave-real-browser-mcp-server@latest --mode http --port 3000
 💡 [HTTP] Universal mode - works with ALL AI IDEs
 ```
 
-#### Step 2: Verify WebSocket Connection
-
-Test WebSocket connection using browser console or Node.js:
-
-**Using Browser Console:**
-
-```javascript
-// Open browser console (F12) and paste:
-const ws = new WebSocket('ws://localhost:3000');
-
-ws.onopen = () => {
-  console.log('✅ WebSocket connected!');
-  
-  // Test tool execution
-  ws.send(JSON.stringify({
-    id: 1,
-    tool: 'browser_init',
-    args: {}
-  }));
-};
-
-ws.onmessage = (event) => {
-  console.log('📥 Response:', JSON.parse(event.data));
-};
-
-ws.onerror = (error) => {
-  console.error('❌ WebSocket error:', error);
-};
-
-ws.onclose = () => {
-  console.log('🔴 WebSocket disconnected');
-};
-```
-
-**Using Node.js:**
-
-```javascript
-// Install ws package: npm install ws
-const WebSocket = require('ws');
-
-const ws = new WebSocket('ws://localhost:3000');
-
-ws.on('open', () => {
-  console.log('✅ WebSocket connected!');
-  
-  // Execute a tool
-  ws.send(JSON.stringify({
-    id: 1,
-    tool: 'browser_init',
-    args: {}
-  }));
-});
-
-ws.on('message', (data) => {
-  console.log('📥 Response:', JSON.parse(data));
-});
-
-ws.on('error', (error) => {
-  console.error('❌ Error:', error);
-});
-
-ws.on('close', () => {
-  console.log('🔴 Connection closed');
-});
-```
-
-#### Step 3: WebSocket Message Format
-
-**Request Format:**
-
-```json
-{
-  "id": 1,
-  "tool": "tool_name",
-  "args": {
-    "param1": "value1",
-    "param2": "value2"
-  }
-}
-```
-
-**Response Format:**
-
-```json
-{
-  "id": 1,
-  "success": true,
-  "result": {
-    "content": [
-      {
-        "type": "text",
-        "text": "Result data"
-      }
-    ]
-  }
-}
-```
-
-**Error Response:**
-
-```json
-{
-  "id": 1,
-  "success": false,
-  "error": "Error message"
-}
-```
-
-#### Step 4: Example - Complete Browser Automation via WebSocket
-
-```javascript
-const WebSocket = require('ws');
-const ws = new WebSocket('ws://localhost:3000');
-
-let messageId = 0;
-
-function sendCommand(tool, args) {
-  return new Promise((resolve, reject) => {
-    const id = ++messageId;
-    
-    const handler = (data) => {
-      const response = JSON.parse(data);
-      if (response.id === id) {
-        ws.removeListener('message', handler);
-        if (response.success) {
-          resolve(response.result);
-        } else {
-          reject(new Error(response.error));
-        }
-      }
-    };
-    
-    ws.on('message', handler);
-    
-    ws.send(JSON.stringify({ id, tool, args }));
-  });
-}
-
-ws.on('open', async () => {
-  try {
-    // Step 1: Initialize browser
-    console.log('Initializing browser...');
-    await sendCommand('browser_init', {});
-    
-    // Step 2: Navigate to URL
-    console.log('Navigating to page...');
-    await sendCommand('navigate', { url: 'https://example.com' });
-    
-    // Step 3: Get page content
-    console.log('Getting content...');
-    const content = await sendCommand('get_content', { type: 'text' });
-    console.log('Content:', content);
-    
-    // Step 4: Close browser
-    console.log('Closing browser...');
-    await sendCommand('browser_close', {});
-    
-    console.log('✅ Automation complete!');
-    ws.close();
-  } catch (error) {
-    console.error('❌ Error:', error);
-    ws.close();
-  }
-});
-```
-
-#### Step 5: WebSocket Client Libraries
-
-**JavaScript/Node.js:**
-```bash
-npm install ws
-```
-
-**Python:**
-```bash
-pip install websockets
-```
-
-```python
-import asyncio
-import websockets
-import json
-
-async def automation():
-    uri = "ws://localhost:3000"
-    async with websockets.connect(uri) as websocket:
-        # Initialize browser
-        await websocket.send(json.dumps({
-            "id": 1,
-            "tool": "browser_init",
-            "args": {}
-        }))
-        response = await websocket.recv()
-        print(f"Response: {response}")
-        
-        # Navigate
-        await websocket.send(json.dumps({
-            "id": 2,
-            "tool": "navigate",
-            "args": {"url": "https://example.com"}
-        }))
-        response = await websocket.recv()
-        print(f"Response: {response}")
-
-asyncio.run(automation())
-```
-
-**Go:**
-```bash
-go get github.com/gorilla/websocket
-```
-
-```go
-package main
-
-import (
-    "encoding/json"
-    "fmt"
-    "github.com/gorilla/websocket"
-)
-
-type Message struct {
-    ID   int                    `json:"id"`
-    Tool string                 `json:"tool"`
-    Args map[string]interface{} `json:"args"`
-}
-
-func main() {
-    ws, _, err := websocket.DefaultDialer.Dial("ws://localhost:3000", nil)
-    if err != nil {
-        panic(err)
-    }
-    defer ws.Close()
-    
-    // Initialize browser
-    msg := Message{
-        ID:   1,
-        Tool: "browser_init",
-        Args: make(map[string]interface{}),
-    }
-    
-    ws.WriteJSON(msg)
-    
-    var response map[string]interface{}
-    ws.ReadJSON(&response)
-    fmt.Printf("Response: %+v\n", response)
-}
-```
-
-**PHP:**
-```bash
-composer require textalk/websocket
-```
-
-```php
-<?php
-require 'vendor/autoload.php';
-
-use WebSocket\Client;
-
-$client = new Client("ws://localhost:3000");
-
-// Initialize browser
-$client->send(json_encode([
-    'id' => 1,
-    'tool' => 'browser_init',
-    'args' => new stdClass()
-]));
-
-$response = json_decode($client->receive());
-echo "Response: " . print_r($response, true);
-
-$client->close();
-?>
-```
-
 #### Step 6: WebSocket Advanced Features
 
 **Connection Options:**

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`, {

package/package.json

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