brave-real-browser-mcp-server 2.14.4 → 2.14.6

package/README.md

@@ -4,17 +4,15 @@
 
 <div align="center">
 
-![Version](https://img.shields.io/badge/version-2.12.1-blue.svg)
+![Version](https://img.shields.io/badge/version-2.14.0-blue.svg)
 ![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green.svg)
-![Tools](https://img.shields.io/badge/tools-111-purple.svg)
+![Tools](https://img.shields.io/badge/tools-108-purple.svg)
 ![IDEs](https://img.shields.io/badge/AI_IDEs-15+-orange.svg)
 ![License](https://img.shields.io/badge/license-MIT-red.svg)
 
-**सभी AI IDEs के लिए Universal MCP Server | 111+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
+**सभी AI IDEs के लिए Universal MCP Server | 108+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
 
-[📖 **All 5 Protocols Complete Guide**](./ALL-PROTOCOLS.md) 👈 **NEW! Step-by-step setup for all protocols**
-
-[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-111) | [HTTP/WebSocket/SSE](#-httpwebsocketsse-protocol-setup) | [IDE Configurations](#-ide-configurations)
+[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-108) | [IDE Configurations](#-ide-configurations)
 
 </div>
 
@@ -25,8 +23,8 @@
 **Brave Real Browser MCP Server** एक powerful automation tool है जो:
 
 - ✅ **15+ AI IDEs में काम करता है** (Claude, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.)
-- ✅ **111+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
-- ✅ **5 Protocol Modes** - MCP (STDIO), LSP, HTTP/WebSocket, SSE
+- ✅ **108+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
+- ✅ **MCP Protocol (STDIO)** - Fast and secure local communication
 - ✅ **Auto-Detection** - Automatically detects your IDE
 - ✅ **Real Brave Browser** - Anti-detection features, bypass Cloudflare
 - ✅ **Universal API** - Works with any programming language (JS, Python, PHP, Go, etc.)
@@ -44,31 +42,13 @@
 | **Claude Desktop** | 2 min | MCP | Add config → Restart | 
 | **Cursor AI** | 2 min | MCP | Add config → Restart |
 | **Windsurf** | 2 min | MCP | Add config → Restart |
-| **Zed Editor** | 3 min | LSP | Add to `context_servers` → Restart |
-|| **Qoder AI** | 3 min | MCP (STDIO/SSE) | Add config → Restart |
-| **Custom Apps** | 1 min | HTTP/WebSocket/SSE | Start server → Use API |
+| **Qoder AI** | 3 min | MCP (STDIO) | Add config → Restart |
 
 **Quick Commands:**
 
 ```bash
 # Auto-detect environment
 npx brave-real-browser-mcp-server@latest
-
-# MCP mode (Claude, Cursor, Windsurf)
-npx brave-real-browser-mcp-server@latest --mode mcp
-
-# LSP mode (Zed, VSCode, Neovim)
-npx brave-real-browser-mcp-server@latest --mode lsp
-
-# HTTP mode (Universal API + WebSocket)
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
-
-# SSE mode (Real-time monitoring)
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
-
-# Check if working
-curl http://localhost:3000/health  # For HTTP mode
-curl http://localhost:3001/health  # For SSE mode
 ```
 
 ---
@@ -101,334 +81,25 @@ npx brave-real-browser-mcp-server@latest
 **Config file locations:**
 
 - **Claude Desktop:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
-- **Cursor:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+- **Cursor:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings<tool_call>_mcp_settings.json`
 - **Windsurf:** `%APPDATA%\Windsurf\mcp.json`
 
 ### For Qoder AI
 
-**Qoder AI supports 2 MCP transport types:** STDIO (local) and SSE (remote)
+**Qoder AI supports MCP servers through **STDIO** (Standard Input/Output).
 
 **Complete step-by-step guide:** [See Qoder AI Integration Guide](#-qoder-ai---complete-integration-guide)
 
 **Quick setup (STDIO):**
 1. Add to config: `{"command": "npx", "args": ["-y", "brave-real-browser-mcp-server@latest"]}`
 2. Restart Qoder AI
-3. Use 111 browser automation tools!
-
-### For Other Custom Tools
-
-Use HTTP/WebSocket/SSE mode - [See Protocol Setup](#-httpwebsocketsse-protocol-setup)
-
----
-
-## 🌐 HTTP/WebSocket/SSE Protocol Setup
-
-### 1️⃣ HTTP Protocol - Complete Configuration
-
-HTTP mode works with **ANY IDE or programming language**. No special configuration needed!
-
-#### Step 1: Start HTTP Server
-
-```bash
-# Start server on port 3000
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
-
-# Custom host and port
-npx brave-real-browser-mcp-server@latest --mode http --host 0.0.0.0 --port 8080
-
-# HTTP only (without WebSocket)
-npx brave-real-browser-mcp-server@latest --mode http --port 3000 --no-websocket
-
-# With custom Brave browser path
-set BRAVE_PATH=C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
-```
-
-**Server will start and show:**
-
-```
-🟢 [HTTP] Starting HTTP/WebSocket server...
-✅ [HTTP] Server ready at http://localhost:3000
-✅ [WebSocket] Server running on ws://localhost:3000
-💡 [HTTP] Universal mode - works with ALL AI IDEs
-```
-
-#### Step 2: Test Server
-
-```bash
-# Health check
-curl http://localhost:3000/health
-
-# List all available tools
-curl http://localhost:3000/tools
-
-# Get specific tool info
-curl http://localhost:3000/tools/browser_init
-```
-
-#### Step 3: Available HTTP Endpoints
-
-| Method | Endpoint | Description | Example |
-|--------|----------|-------------|----------|
-| **GET** | `/health` | Health check | `curl http://localhost:3000/health` |
-| **GET** | `/tools` | List all 111 tools | `curl http://localhost:3000/tools` |
-| **GET** | `/tools/:toolName` | Get tool info | `curl http://localhost:3000/tools/browser_init` |
-| **POST** | `/tools/:toolName` | Execute any tool | See documentation |
-
-#### Step 4: MCP Configuration for HTTP
-
-If your IDE supports HTTP-based MCP servers, use this configuration:
-
-**Config format:**
-```json
-{
-  "mcpServers": {
-    "brave-real-browser-http": {
-      "url": "http://localhost:3000",
-      "transport": "http",
-      "name": "Brave Browser (HTTP)",
-      "enabled": true
-    }
-  }
-}
-```
-
-**With authentication:**
-```json
-{
-  "mcpServers": {
-    "brave-real-browser-http": {
-      "url": "http://localhost:3000",
-      "transport": "http",
-      "headers": {
-        "Authorization": "Bearer your-token"
-      },
-      "enabled": true
-    }
-  }
-}
-```
-
-#### Step 5: Error Handling
-
-**Success Response:**
-```json
-{
-  "success": true,
-  "data": {
-    "result": "Browser initialized successfully"
-  }
-}
-```
-
-**Error Response:**
-```json
-{
-  "success": false,
-  "error": "Browser initialization failed",
-  "details": "Brave browser not found at specified path"
-}
-```
-
----
-
-### 2️⃣ WebSocket Protocol - Complete Configuration
-
-WebSocket provides **real-time, bidirectional communication** for modern applications.
-
-#### Step 1: Start WebSocket Server
-
-```bash
-# WebSocket is automatically enabled with HTTP mode
-npx brave-real-browser-mcp-server@latest --mode http --port 3000
-
-# WebSocket will be available at: ws://localhost:3000
-```
-
-**Server will start and show:**
-
-```
-🟢 [HTTP] Starting HTTP/WebSocket server...
-✅ [HTTP] Server ready at http://localhost:3000
-✅ [WebSocket] Server running on ws://localhost:3000
-💡 [HTTP] Universal mode - works with ALL AI IDEs
-```
-
-#### Step 2: WebSocket Message Format
-
-**Request Format:**
-```json
-{
-  "tool": "tool_name",
-  "params": {
-    "param1": "value1",
-    "param2": "value2"
-  }
-}
-```
-
-**Response Format:**
-```json
-{
-  "success": true,
-  "tool": "browser_init",
-  "data": {
-    "result": "Browser initialized successfully"
-  },
-  "timestamp": "2025-01-25T04:20:00.000Z"
-}
-```
-
-#### Step 3: MCP Configuration for WebSocket
-
-If your IDE supports WebSocket-based MCP servers:
-
-**Config format:**
-```json
-{
-  "mcpServers": {
-    "brave-real-browser-ws": {
-      "url": "ws://localhost:3000",
-      "transport": "websocket",
-      "name": "Brave Browser (WebSocket)",
-      "enabled": true
-    }
-  }
-}
-```
-
-**With custom options:**
-```json
-{
-  "mcpServers": {
-    "brave-real-browser-ws": {
-      "url": "ws://localhost:3000",
-      "transport": "websocket",
-      "reconnect": true,
-      "reconnectDelay": 3000,
-      "headers": {
-        "Authorization": "Bearer your-token"
-      },
-      "enabled": true
-    }
-  }
-}
-```
-
-#### Step 4: WebSocket Features
-
-**WebSocket URL:** `ws://localhost:3000`
-
-**Features:**
-- ✅ Real-time bidirectional communication
-- ✅ Auto-reconnection support
-- ✅ Ping/Pong keep-alive
-- ✅ Custom headers support
-- ✅ All 111 tools accessible
-
----
-
-### 3️⃣ SSE Protocol - Complete Configuration
-
-Server-Sent Events (SSE) provides **real-time, one-way streaming** from server to client.
-
-#### Step 1: Start SSE Server
-
-```bash
-# Default (port 3001)
-npx brave-real-browser-mcp-server@latest --mode sse
-
-# Custom port
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
-
-# Custom host
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001 --host 0.0.0.0
-
-# With custom Brave path
-set BRAVE_PATH=C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
-```
-
-**Server will start and show:**
-
-```
-🟢 [SSE] Starting SSE server...
-✅ [SSE] Server ready at http://localhost:3001
-💡 [SSE] Real-time monitoring enabled
-```
-
-#### Step 2: Test SSE Server
-
-```bash
-# Health check
-curl http://localhost:3001/health
-
-# List available event types
-curl http://localhost:3001/events/types
-```
-
-#### Step 3: Available SSE Event Types
-
-| Event Type | Description | Example Data |
-|------------|-------------|-------------|
-| `browser_init_success` | Browser initialized | `{"status": "ready", "pid": 12345}` |
-| `browser_init_error` | Browser failed to start | `{"error": "Brave not found"}` |
-| `navigation_start` | Navigation started | `{"url": "https://example.com"}` |
-| `navigation_complete` | Navigation finished | `{"url": "https://example.com", "time": 1250}` |
-| `tool_start` | Tool execution started | `{"tool": "scrape_table"}` |
-| `tool_success` | Tool completed successfully | `{"tool": "scrape_table", "result": [...]}` |
-| `tool_error` | Tool execution failed | `{"tool": "scrape_table", "error": "Selector not found"}` |
-| `content_extracted` | Content extracted | `{"type": "html", "size": 50000}` |
-| `screenshot_captured` | Screenshot taken | `{"path": "/path/to/screenshot.png"}` |
-| `error_occurred` | General error | `{"error": "Connection timeout"}` |
-
-#### Step 4: MCP Configuration for SSE
-
-If your IDE supports SSE-based MCP servers:
-
-**Config format:**
-```json
-{
-  "mcpServers": {
-    "brave-real-browser-sse": {
-      "url": "http://localhost:3001/sse",
-      "transport": "sse",
-      "name": "Brave Browser (SSE)",
-      "enabled": true
-    }
-  }
-}
-```
-
-**With event filters:**
-```json
-{
-  "mcpServers": {
-    "brave-real-browser-sse": {
-      "url": "http://localhost:3001/sse?filter=tool_success,navigation_complete",
-      "transport": "sse",
-      "reconnect": true,
-      "enabled": true
-    }
-  }
-}
-```
-
-#### Step 5: SSE Advanced Features
-
-**Custom Event Filters:**
-```bash
-# Connect with filter query parameter
-curl http://localhost:3001/events?filter=tool_success,navigation_complete
-```
+3. Use 108 browser automation tools!
 
 ---
 
 ## 🤖 Qoder AI - Complete Integration Guide
 
-**Qoder AI** supports MCP servers through **2 official transport types:**
-- ✅ **STDIO** (Standard Input/Output) - For local MCP servers
-- ✅ **SSE** (Server-Sent Events) - For remote MCP servers
+**Qoder AI** supports MCP servers through **STDIO** (Standard Input/Output).
 
 [Official Documentation](https://docs.qoder.com/user-guide/chat/model-context-protocol)
 
@@ -510,7 +181,7 @@ In Qoder AI, test:
 
 ```
 "List all available MCP tools"
-→ Expected: 111 tools from Brave Real Browser
+→ Expected: 108 tools from Brave Real Browser
 
 "Use browser_init to start the browser"
 → Expected: Browser opens
@@ -521,85 +192,6 @@ In Qoder AI, test:
 
 ---
 
-### 🔵 Method 2: SSE Transport (For Remote MCP Servers)
-
-**SSE** uses HTTP POST for requests and event streams for responses. Perfect for remote hosted servers.
-
-#### Step 1: Start SSE Server
-
-```bash
-# Windows
-set BRAVE_PATH=C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
-
-# Mac
-export BRAVE_PATH="/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
-
-# Linux
-export BRAVE_PATH="/usr/bin/brave-browser"
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3001
-```
-
-**Server will start:**
-```
-🟢 [SSE] Starting SSE server...
-✅ [SSE] Server ready at http://localhost:3001
-💡 [SSE] Real-time monitoring enabled
-```
-
-#### Step 2: Configure Qoder AI for SSE
-
-**In Qoder AI Settings → MCP Servers:**
-
-```json
-{
-  "brave-real-browser": {
-    "url": "http://localhost:3001/sse",
-    "transport": "sse",
-    "name": "Brave Real Browser (SSE)",
-    "enabled": true
-  }
-}
-```
-
-#### Step 3: Restart Qoder AI
-
-Close and reopen Qoder AI.
-
----
-
-### 🛠️ Using Brave Browser in Qoder AI
-
-Once configured, you can use **all 111 tools** in Qoder AI:
-
-**Example 1: Web Scraping**
-```
-"Initialize browser, navigate to https://news.ycombinator.com and scrape all article titles"
-```
-
-**Example 2: Form Automation**
-```
-"Open https://example.com/login, fill the form with username 'test' and password 'pass123', then click submit"
-```
-
-**Example 3: Data Extraction**
-```
-"Go to https://example.com/products and extract all product names, prices, and images"
-```
-
-**Example 4: Video Extraction**
-```
-"Navigate to [video URL] and extract all video download links"
-```
-
-**Example 5: Screenshot**
-```
-"Take a full-page screenshot of https://example.com and save it"
-```
-
----
-
 ### ⚡ Quick Troubleshooting for Qoder AI
 
 **Problem 1: "MCP Server timeout" or "Connection failed"**
@@ -640,22 +232,11 @@ Then update config to:
 }
 ```
 
-**Problem 4: "SSE server not connecting"**
-
-**Solution:**
-```bash
-# Check if server is running
-curl http://localhost:3001/health
-
-# Try different port
-npx brave-real-browser-mcp-server@latest --mode sse --sse-port 3002
-```
-
 ---
 
 ### 📊 Available Tools in Qoder AI
 
-All **111 tools** are available:
+All **108 tools** are available:
 
 ✅ **Browser Management:** `browser_init`, `browser_close`  
 ✅ **Navigation:** `navigate`, `wait`, `click`, `type`  
@@ -664,12 +245,13 @@ All **111 tools** are available:
 ✅ **CAPTCHA Solving:** `solve_captcha`, `ocr_engine`  
 ✅ **Data Processing:** `price_parser`, `date_normalizer`, `contact_extractor`  
 ✅ **Visual Tools:** `full_page_screenshot`, `pdf_generation`  
-✅ **And 90+ more tools!**
+✅ **And 87+ more tools!**
 
 ---
 
 ## 🎨 IDE Configurations
 
+### Claude Desktop
 
 **Step 2: Add Configuration**
 
@@ -781,7 +363,7 @@ Copy and paste this configuration:
 
 **Location:**
 
-- Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+- Windows: `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings<tool_call>_mcp_settings.json`
 - Mac: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
 
 ```json
@@ -795,109 +377,7 @@ Copy and paste this configuration:
 }
 ```
 
-### Zed Editor
-
-**Protocol:** Context Servers (MCP)
-
-**File:** `settings.json`
-
-**Location:**
-
-- Windows: `%APPDATA%\Zed\settings.json`
-- Mac: `~/.config/zed/settings.json`
-- Linux: `~/.config/zed/settings.json`
-
-#### Step-by-Step Setup Guide:
-
-**Step 1:** Open Zed Editor and press `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (Mac)
-
-**Step 2:** Type "Open Settings" and select "Zed: Open Settings"
-
-**Step 3:** Add the following configuration:
-
-```json
-{
-  "context_servers": {
-    "brave-real-browser": {
-      "source": "custom",
-      "command": "npx.cmd",
-      "args": ["-y", "brave-real-browser-mcp-server"]
-    }
-  }
-}
-```
-
-**For Mac/Linux, use:**
-```json
-{
-  "context_servers": {
-    "brave-real-browser": {
-      "source": "custom",
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server"]
-    }
-  }
-}
-```
-
-**Note:** Replace path in Option C with your actual global npm modules path:
-- Windows: `%APPDATA%\npm\node_modules\brave-real-browser-mcp-server\dist\index.js`
-- Mac/Linux: `/usr/local/lib/node_modules/brave-real-browser-mcp-server/dist/index.js`
-
-**Advanced Configuration (with environment variables):**
-
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"],
-      "env": {
-        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
-        "HEADLESS": "false"
-      }
-    }
-  }
-}
-```
-
-**For Mac:**
-
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"],
-      "env": {
-        "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
-      }
-    }
-  }
-}
-```
-
-**Cause:** Qoder AI has a short initialization timeout. Using `npx` can be slow on first run because it needs to download and cache the package.
-
-**Solution 1 - Install Globally (Recommended):**
-```bash
-# Install package globally for instant startup
-npm install -g brave-real-browser-mcp-server@latest
-```
-
-Then update your configuration to:
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "brave-real-browser-mcp-server",
-      "args": []
-    }
-  }
-}
-```
-
-## 🛠️ Available Tools (111)
+## 🛠️ Available Tools (108)
 
 ### 🌐 Browser Management (2 tools)
 
@@ -960,10 +440,10 @@ Then update your configuration to:
 | `ajax_extractor`       | Extract AJAX/dynamic content |
 | `fetch_xhr`            | Capture XHR/Fetch requests   |
 | `network_recorder`     | Record all network traffic   |
-| `api_finder`           | Discover API endpoints       |
 | `regex_pattern_finder` | Find patterns using regex    |
 | `iframe_extractor`     | Extract iframe content       |
 | `embed_page_extractor` | Extract embedded pages       |
+| `user_agent_extractor` | Extract user agent info      |
 
 ### 🎬 Video & Media Tools (19 tools)
 
@@ -1083,15 +563,7 @@ Then update your configuration to:
 | `performance_monitor`   | Monitor performance       |
 | `monitoring_summary`    | Get monitoring summary    |
 
-### 🌐 API Integration (3 tools)
-
-| Tool                       | Description              |
-| -------------------------- | ------------------------ |
-| `rest_api_endpoint_finder` | Find REST API endpoints  |
-| `webhook_support`          | Webhook integration      |
-| `all_website_api_finder`   | Find all APIs on website |
-
-### 🛡️ Advanced Extraction & Obfuscation (5 tools)
+### 🛡️ Advanced Extraction & Obfuscation (4 tools)
 
 | Tool                         | Description                 |
 | ---------------------------- | --------------------------- |
@@ -1099,7 +571,6 @@ Then update your configuration to:
 | `multi_layer_redirect_trace` | Trace multi-layer redirects |
 | `ad_protection_detector`     | Detect ad protection        |
 | `url_redirect_tracer`        | Trace URL redirects         |
-| `user_agent_extractor`       | Extract user agent info     |
 
 
 ## 🔧 Environment Variables
@@ -1113,9 +584,6 @@ HEADLESS=true
 
 # Optional: Disable content priority
 DISABLE_CONTENT_PRIORITY=true
-
-# Optional: HTTP port
-HTTP_PORT=3000
 ```
 
 ## 📊 Supported Protocols
@@ -1123,10 +591,6 @@ HTTP_PORT=3000
 || Protocol        | Used By                                       | Auto-Config | Status     |
 || --------------- | --------------------------------------------- | ----------- | ---------- |
 || **MCP (STDIO)** | Claude Desktop, Cursor, Windsurf, Cline, Warp | ✅          | 🟢 Working |
-|| **LSP**         | Zed Editor, VSCode, Neovim                    | ✅          | 🟢 Working |
-|| **HTTP/REST**   | Any IDE/Tool                                  | ✅          | 🟢 Working |
-|| **WebSocket**   | Modern Web Apps, Real-time Tools              | ✅          | 🟢 Working |
-|| **SSE**         | Real-time Streaming, Web Apps                 | ✅          | 🟢 Working |
 
 ## 📄 License
 
@@ -1144,7 +608,6 @@ MIT License - See LICENSE file for details.
 
 <div align="center">
 
-**🌟 111 Tools | 15+ AI IDEs | 5 Protocols | Universal Support 🌟**
+**🌟 108 Tools | 15+ AI IDEs | MCP Protocol | Universal Support 🌟**
 
 **Made with ❤️ for the AI Development Community**
-