brave-real-browser-mcp-server 2.14.11 → 2.14.12

package/README.md

@@ -59,206 +59,47 @@ npx brave-real-browser-mcp-server@latest
 ### Installation
 
 ```bash
-# Install globally
-npm install -g brave-real-browser-mcp-server@latest
-
-# Or use with npx (no installation needed)
+# Recommended: Use directly with npx (No install needed)
 npx brave-real-browser-mcp-server@latest
-```
-
-### For MCP IDEs (Claude, Cursor, Windsurf)
-
-**Add to your IDE config file:**
 
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
-    }
-  }
-}
+# Alternative: Install globally
+npm install -g 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<tool_call>_mcp_settings.json`
-- **Windsurf:** `%APPDATA%\Windsurf\mcp.json`
-
-### For Qoder AI
-
-**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 108 browser automation tools!
-
 ---
 
-## 🤖 Qoder AI - Complete Integration Guide
-
-**Qoder AI** supports MCP servers through **STDIO** (Standard Input/Output).
-
-[Official Documentation](https://docs.qoder.com/user-guide/chat/model-context-protocol)
-
----
-
-### 🟢 Method 1: STDIO Transport (Recommended for Local)
-
-**STDIO** uses stdin/stdout streams for communication. Perfect for local MCP servers.
-
-#### Step 1: Find Qoder AI MCP Config File
-
-**Config file locations:**
-
-```bash
-# Windows
-%APPDATA%\Qoder\mcp_settings.json
-
-# Mac
-~/Library/Application Support/Qoder/mcp_settings.json
-
-# Linux
-~/.config/Qoder/mcp_settings.json
-```
+## 🎨 IDE Configurations
 
-#### Step 2: Add STDIO Configuration
+### 1. Claude Desktop
+**File:** `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)
 
-**Windows Configuration:**
 ```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"
-      }
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Mac Configuration:**
-```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"
-      }
-    }
-  }
-}
-```
+### 2. Cursor AI
+**File:** `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\mcp_settings.json`
 
-**Linux Configuration:**
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
       "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"],
-      "env": {
-        "BRAVE_PATH": "/usr/bin/brave-browser"
-      }
-    }
-  }
-}
-```
-
-#### Step 3: Restart Qoder AI
-
-Close and reopen Qoder AI completely.
-
-#### Step 4: Verify Integration
-
-In Qoder AI, test:
-
-```
-"List all available MCP tools"
-→ Expected: 108 tools from Brave Real Browser
-
-"Use browser_init to start the browser"
-→ Expected: Browser opens
-
-"Navigate to https://example.com and get content"
-→ Expected: Page content extracted
-```
-
----
-
-### ⚡ Quick Troubleshooting for Qoder AI
-
-**Problem 1: "MCP Server timeout" or "Connection failed"**
-
-**Solution:**
-```bash
-# Install globally for faster startup
-npm install -g brave-real-browser-mcp-server@latest
-```
-
-Then update config to:
-```json
-{
-  "mcpServers": {
-    "brave-real-browser": {
-      "command": "brave-real-browser-mcp-server",
-      "args": []
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Problem 2: "Tools not showing in Qoder AI"**
-
-**Solution:**
-1. Check config file path is correct
-2. Verify JSON format is valid
-3. Restart Qoder AI completely
-4. Check Qoder AI logs for errors
-
-**Problem 3: "Browser not opening"**
-
-**Solution:**
-```bash
-# Set Brave path explicitly in config
-"env": {
-  "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
-}
-```
-
----
-
-### 📊 Available Tools in Qoder AI
-
-All **108 tools** are available:
-
-✅ **Browser Management:** `browser_init`, `browser_close`  
-✅ **Navigation:** `navigate`, `wait`, `click`, `type`  
-✅ **Content Extraction:** `get_content`, `scrape_table`, `extract_json`, `scrape_meta_tags`  
-✅ **Media Tools:** `video_link_finder`, `image_scraper`, `media_extractor`  
-✅ **CAPTCHA Solving:** `solve_captcha`, `ocr_engine`  
-✅ **Data Processing:** `price_parser`, `date_normalizer`, `contact_extractor`  
-✅ **Visual Tools:** `full_page_screenshot`, `pdf_generation`  
-✅ **And 87+ more tools!**
-
----
-
-## 🎨 IDE Configurations
-
-### Claude Desktop
-
-**Step 2: Add Configuration**
-
-Copy and paste this configuration:
+### 3. Windsurf
+**File:** `%APPDATA%\Windsurf\mcp.json` (Windows) or `~/.windsurf/mcp.json` (Mac)
 
 ```json
 {
@@ -271,33 +112,24 @@ Copy and paste this configuration:
 }
 ```
 
-**Advanced Configuration (Optional):**
+### 4. Antigravity IDE
+**Auto-Detection:** Automatically detects installed MCP servers.
+**Manual Config:** Add to project config if needed:
 
 ```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"
-      }
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-**Configuration Locations:**
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- Linux: `~/.config/Claude/claude_desktop_config.json`
-
-### Cursor AI
+### 5. Warp AI
+**File:** `~/.warp/mcp_config.json`
 
-**Step 3: Add Configuration**
-
-**Basic Configuration:**
 ```json
 {
   "mcpServers": {
@@ -309,45 +141,22 @@ Copy and paste this configuration:
 }
 ```
 
-**Advanced Configuration (with Brave path):**
-```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"
-      }
-    }
-  }
-}
-```
+### 6. Zed AI
+**File:** `.zed/settings.json`
 
-**For Mac:**
 ```json
 {
-  "mcpServers": {
+  "mcp_servers": {
     "brave-real-browser": {
       "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"],
-      "env": {
-        "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
-      }
+      "args": ["-y", "brave-real-browser-mcp-server@latest"]
     }
   }
 }
 ```
 
-### Windsurf
-
-**File:** `mcp.json`
-
-**Location:**
-
-- Windows: `%APPDATA%\Windsurf\mcp.json`
-- Mac: `~/.windsurf/mcp.json`
+### 7. Cline (VSCode Extension)
+**File:** `cline_mcp_settings.json`
 
 ```json
 {
@@ -360,26 +169,26 @@ Copy and paste this configuration:
 }
 ```
 
-### Cline (VSCode Extension)
-
-**File:** `cline_mcp_settings.json`
-
-**Location:**
-
-- 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`
+### 8. Qoder AI
+**File:** `%APPDATA%\Qoder\mcp_settings.json` (Windows) or `~/.config/Qoder/mcp_settings.json` (Linux)
+**Note:** Qoder AI uses STDIO.
 
 ```json
 {
   "mcpServers": {
     "brave-real-browser": {
       "command": "npx",
-      "args": ["-y", "brave-real-browser-mcp-server@latest"]
+      "args": ["-y", "brave-real-browser-mcp-server@latest"],
+      "env": {
+        "BRAVE_PATH": "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+      }
     }
   }
 }
 ```
 
+---
+
 ## 🛠️ Available Tools (108)
 
 ### 🌐 Browser Management (2 tools)
@@ -560,7 +369,6 @@ Copy and paste this configuration:
 | Tool                    | Description               |
 | ----------------------- | ------------------------- |
 | `progress_tracker`      | Track automation progress |
-
 | `success_rate_reporter` | Report success rates      |
 | `data_quality_metrics`  | Data quality metrics      |
 | `performance_monitor`   | Monitor performance       |
@@ -578,15 +386,26 @@ Copy and paste this configuration:
 
 ## 🔧 Environment Variables
 
+You can configure the server using a local `.env` file (recommended for development) or by passing variables in your IDE config.
+
+1. Copy `.env.example` to `.env`:
+   ```bash
+   cp .env.example .env
+   ```
+2. Edit `.env` to set your preferences:
+
 ```bash
 # Optional: Specify Brave browser path
 BRAVE_PATH="C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe"
 
-# Optional: Run in headless mode
+# Optional: Run in headless mode (default: false)
 HEADLESS=true
 
 # Optional: Disable content priority
 DISABLE_CONTENT_PRIORITY=true
+
+# Optional: Proxy URL
+PROXY_URL=http://localhost:8080
 ```
 
 ## 📊 Supported Protocols

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 // Debug logging setup - Log process start
+import 'dotenv/config';
 console.error(`🔍 [DEBUG] Process starting - PID: ${process.pid}, Node: ${process.version}, Platform: ${process.platform}`);
 console.error(`🔍 [DEBUG] Working directory: ${process.cwd()}`);
 console.error(`🔍 [DEBUG] Command args: ${process.argv.join(" ")}`);

package/package.json

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