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

package/README.md

@@ -22,7 +22,7 @@
 
 **Brave Real Browser MCP Server** एक powerful automation tool है जो:
 
-- ✅ **15+ AI IDEs में काम करता है** (Claude, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.)
+- ✅ **20+ AI IDEs में काम करता है** (Antigravity, Warp AI, Zed, Cursor, Claude, Windsurf, Cline, Qoder AI, etc.)
 - ✅ **108+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
 - ✅ **MCP Protocol (STDIO)** - Fast and secure local communication
 - ✅ **Auto-Detection** - Automatically detects your IDE
@@ -42,6 +42,9 @@
 | **Claude Desktop** | 2 min | MCP | Add config → Restart | 
 | **Cursor AI** | 2 min | MCP | Add config → Restart |
 | **Windsurf** | 2 min | MCP | Add config → Restart |
+| **Antigravity IDE** | 1 min | MCP | Auto-Detect |
+| **Warp AI** | 2 min | MCP | Add config |
+| **Zed AI** | 2 min | MCP | Add config |
 | **Qoder AI** | 3 min | MCP (STDIO) | Add config → Restart |
 
 **Quick Commands:**
@@ -56,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
 {
@@ -268,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": {
@@ -306,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
 {
@@ -357,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)
@@ -557,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       |
@@ -575,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/dist/tool-definitions.js

@@ -333,7 +333,7 @@ export const TOOLS = [
     // Smart Data Extractors
     {
         name: 'extract_list',
-        description: 'Bullet lists और numbered lists से data extract करता है',
+        description: 'Extract data from bullet lists and numbered lists',
         inputSchema: {
             type: 'object',
             properties: {
@@ -345,7 +345,7 @@ export const TOOLS = [
     },
     {
         name: 'extract_json',
-        description: 'Page में embedded JSON/API data extract करता है',
+        description: 'Extract embedded JSON/API data from the page',
         inputSchema: {
             type: 'object',
             properties: {
@@ -357,7 +357,7 @@ export const TOOLS = [
     },
     {
         name: 'scrape_meta_tags',
-        description: 'SEO meta tags और Open Graph data extract करता है',
+        description: 'Extract SEO meta tags and Open Graph data',
         inputSchema: {
             type: 'object',
             properties: {
@@ -369,7 +369,7 @@ export const TOOLS = [
     },
     {
         name: 'extract_schema',
-        description: 'Schema.org structured data (JSON-LD, Microdata) extract करता है',
+        description: 'Extract Schema.org structured data (JSON-LD, Microdata)',
         inputSchema: {
             type: 'object',
             properties: {
@@ -381,7 +381,7 @@ export const TOOLS = [
     // Multi-Element Extractors
     {
         name: 'batch_element_scraper',
-        description: 'Multiple similar elements को batch में scrape करता है',
+        description: 'Scrape multiple similar elements in a batch',
         inputSchema: {
             type: 'object',
             properties: {
@@ -395,7 +395,7 @@ export const TOOLS = [
     },
     {
         name: 'nested_data_extraction',
-        description: 'Parent-child relationships maintain करते हुए data extract करता है',
+        description: 'Extract data maintaining parent-child relationships',
         inputSchema: {
             type: 'object',
             properties: {
@@ -408,7 +408,7 @@ export const TOOLS = [
     },
     {
         name: 'attribute_harvester',
-        description: 'Elements के attributes (href, src, data-*) collect करता है',
+        description: 'Collect attributes (href, src, data-*) from elements',
         inputSchema: {
             type: 'object',
             properties: {
@@ -422,7 +422,7 @@ export const TOOLS = [
     // Content Type Specific Extractors
     {
         name: 'link_harvester',
-        description: 'Internal/external links classification के साथ collect करता है',
+        description: 'Collect internal/external links with classification',
         inputSchema: {
             type: 'object',
             properties: {
@@ -434,7 +434,7 @@ export const TOOLS = [
     },
     {
         name: 'media_extractor',
-        description: 'Videos, audio, iframes का URLs और metadata extract करता है',
+        description: 'Extract URLs and metadata for videos, audio, and iframes',
         inputSchema: {
             type: 'object',
             properties: {
@@ -446,7 +446,7 @@ export const TOOLS = [
     // Pagination Tools
     {
         name: 'multi_page_scraper',
-        description: 'Multiple pages से data collect और merge करता है',
+        description: 'Collect and merge data from multiple pages',
         inputSchema: {
             type: 'object',
             properties: {
@@ -459,7 +459,7 @@ export const TOOLS = [
     },
     {
         name: 'breadcrumb_navigator',
-        description: 'Site structure follow करके navigation path extract करता है',
+        description: 'Extract navigation path by following site structure',
         inputSchema: {
             type: 'object',
             properties: {
@@ -471,7 +471,7 @@ export const TOOLS = [
     // Data Processing Tools
     {
         name: 'html_to_text',
-        description: 'HTML को clean text में convert करता है',
+        description: 'Convert HTML content to clean text',
         inputSchema: {
             type: 'object',
             properties: {
@@ -485,7 +485,7 @@ export const TOOLS = [
     // Data Validation Tools
     {
         name: 'duplicate_remover',
-        description: 'Array से duplicate items remove करता है',
+        description: 'Remove duplicate items from an array',
         inputSchema: {
             type: 'object',
             properties: {

package/package.json

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