brave-real-browser-mcp-server 1.5.17 → 2.0.4

package/README.md

@@ -3,7 +3,7 @@
 
 # Brave Real Browser MCP Server
 
-Provides AI assistants with powerful, detection-resistant browser automation capabilities built on ZFC Digital's puppeteer-real-browser package.
+Provides AI assistants with powerful, detection-resistant browser automation capabilities built on ZFC Digital's brave-real-browser package.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -13,20 +13,24 @@ Provides AI assistants with powerful, detection-resistant browser automation cap
 2. [Introduction](#introduction)
 3. [Features](#features)
 4. [Prerequisites](#prerequisites)
-5. [Installation](#installation)
-6. [Usage](#usage)
+5. [Platform-Specific Installation](#platform-specific-installation)
+   - [Windows Installation](#windows-installation)
+   - [macOS Installation](#macos-installation)
+   - [Linux Installation](#linux-installation)
+6. [Installation](#installation)
+7. [Usage](#usage)
    - [With Claude Desktop](#with-claude-desktop)
    - [With Claude Code CLI](#with-claude-code-cli)
    - [With Cursor IDE](#with-cursor-ide)
    - [With Other AI Assistants](#with-other-ai-assistants)
-7. [Available Tools](#available-tools)
-8. [Advanced Features](#advanced-features)
-9. [Configuration](#configuration)
-10. [Troubleshooting](#troubleshooting)
-11. [Development](#development)
-12. [Testing](#testing)
-13. [Contributing](#contributing)
-14. [License](#license)
+8. [Available Tools](#available-tools)
+9. [Advanced Features](#advanced-features)
+10. [Configuration](#configuration)
+11. [Troubleshooting](#troubleshooting)
+12. [Development](#development)
+13. [Testing](#testing)
+14. [Contributing](#contributing)
+15. [License](#license)
 
 ## Quick Start for Beginners
 
@@ -103,21 +107,26 @@ Once set up, you can ask Claude to:
 
 ## Introduction
 
-The Puppeteer Real Browser MCP Server acts as a bridge between AI assistants
-and browser automation. It leverages puppeteer-real-browser to provide stealth
-browsing capabilities that can bypass common bot detection mechanisms.
+The Brave Real Browser MCP Server acts as a bridge between AI assistants
+and browser automation. It leverages the **brave-real-browser** package to provide
+advanced stealth browsing capabilities that can bypass common bot detection mechanisms.
+
+**🎯 Optimized for Brave Browser**: While compatible with Chrome and Chromium,
+this server is specifically optimized for Brave Browser, providing enhanced
+privacy, ad-blocking, and anti-fingerprinting capabilities out-of-the-box.
 
 This server implements the Model Context Protocol (MCP), allowing AI
-assistants to control a real browser, extract content, and more.
+assistants to control a real browser, extract content, solve CAPTCHAs, and perform
+complex web automation tasks with human-like behavior.
 
 ## Features
 
 - **Stealth by default**: All browser instances use anti-detection features
-- **Enhanced Windows support**: Comprehensive Chrome detection and ECONNREFUSED error fixes (v1.3.0)
-- **Smart Chrome detection**: Registry-based detection + 15+ installation paths (Windows)
+- **Enhanced Windows support**: Comprehensive Brave/Chrome detection and ECONNREFUSED error fixes
+- **Smart browser detection**: Registry-based detection + 15+ installation paths for Brave and Chrome (Windows)
 - **Connection resilience**: Automatic localhost/127.0.0.1 fallback with port management
 - **Multiple retry strategies**: 5 different connection approaches with progressive fallback
-- **Advanced configuration**: Full support for all puppeteer-real-browser options
+- **Advanced configuration**: Full support for all brave-real-browser options
 - **Dynamic selector discovery**: Intelligent element finding without hardcoded selectors
 - **Random scrolling**: Tools for natural scrolling to avoid detection
 - **Comprehensive toolset**: 11 tools covering all browser automation needs
@@ -132,27 +141,384 @@ assistants to control a real browser, extract content, and more.
 
 - Node.js >= 18.0.0
 - npm or yarn
-- Google Chrome or Chromium browser installed
+- **Brave Browser** (recommended) or Google Chrome/Chromium browser installed
 - Basic understanding of TypeScript/JavaScript (for development)
 
 ### Platform-Specific Requirements
 
 **Windows:**
-- Google Chrome installation (automatic detection in v1.3.0+ includes):
-  - Standard installations: `C:\Program Files\Google\Chrome\Application\chrome.exe`
-  - 32-bit installations: `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
-  - User installations: `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
-  - Chrome Canary: `%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe`
+- **Brave Browser** (recommended) or Google Chrome installation (automatic detection includes):
+  - **Brave Browser paths:**
+    - Standard: `C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe`
+    - 32-bit: `C:\Program Files (x86)\BraveSoftware\Brave-Browser\Application\brave.exe`
+    - User: `%LOCALAPPDATA%\BraveSoftware\Brave-Browser\Application\brave.exe`
+    - Nightly: `%LOCALAPPDATA%\BraveSoftware\Brave-Browser-Nightly\Application\brave.exe`
+  - **Google Chrome paths:**
+    - Standard: `C:\Program Files\Google\Chrome\Application\chrome.exe`
+    - 32-bit: `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
+    - User: `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`
+    - Canary: `%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe`
   - Portable installations and Registry-detected paths
-  - Manual path specification: Use `CHROME_PATH` environment variable
+  - Manual path specification: Use `CHROME_PATH` or `BRAVE_PATH` environment variable
 
 **macOS:**
-- Google Chrome or Chromium must be installed in `/Applications/`
+- **Brave Browser** (recommended): Install from [brave.com](https://brave.com) or App Store
+- Alternative: Google Chrome or Chromium in `/Applications/`
+- **Brave paths:**
+  - `/Applications/Brave Browser.app/Contents/MacOS/Brave Browser`
+  - `/Applications/Brave Browser Nightly.app/Contents/MacOS/Brave Browser Nightly`
 
 **Linux:**
-- Install Chrome/Chromium: `sudo apt-get install -y google-chrome-stable` or `sudo apt-get install -y chromium-browser`
+- **Brave Browser** (recommended):
+  ```bash
+  # Install Brave Browser
+  sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
+  echo "deb [signed-by=/usr/share/keyrings/brave-browser-archive-keyring.gpg] https://brave-browser-apt-release.s3.brave.com/ stable main" | sudo tee /etc/apt/sources.list.d/brave-browser-release.list
+  sudo apt update && sudo apt install brave-browser
+  ```
+- **Alternative Chrome/Chromium:**
+  ```bash
+  sudo apt-get install -y google-chrome-stable
+  # or
+  sudo apt-get install -y chromium-browser
+  ```
 - Install xvfb for headless operation: `sudo apt-get install -y xvfb`
 
+## Platform-Specific Installation
+
+> **🎯 Choose Your Platform:** Select the installation method that matches your operating system. Each section includes complete setup commands for both Brave Browser and MCP server configuration.
+
+### Windows Installation
+
+#### Method 1: Complete Windows Setup (Recommended)
+
+**Step 1: Install Node.js**
+```powershell
+# Download and install from nodejs.org, or use winget
+winget install OpenJS.NodeJS
+
+# Verify installation
+node --version
+npm --version
+```
+
+**Step 2: Install Brave Browser (Recommended)**
+```powershell
+# Option 1: Download from brave.com
+# Visit: https://brave.com/download/
+
+# Option 2: Use winget
+winget install BraveSoftware.BraveBrowser
+
+# Option 3: Use Chocolatey
+choco install brave
+
+# Verify installation
+& "C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe" --version
+```
+
+**Step 3: Setup Claude Desktop MCP Configuration**
+```powershell
+# Create Claude config directory
+$configPath = "$env:APPDATA\Claude"
+if (!(Test-Path $configPath)) { New-Item -ItemType Directory -Path $configPath }
+
+# Create MCP configuration file
+@"
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "npx",
+      "args": ["brave-real-browser-mcp-server@latest"]
+    }
+  }
+}
+"@ | Out-File -FilePath "$configPath\claude_desktop_config.json" -Encoding UTF8
+
+echo "✅ Claude Desktop MCP configuration created successfully!"
+echo "📁 Config file location: $configPath\claude_desktop_config.json"
+```
+
+**Step 4: Setup Environment Variables (Optional)**
+```powershell
+# Set Brave Browser path (if not auto-detected)
+[Environment]::SetEnvironmentVariable("BRAVE_PATH", "C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe", "User")
+
+# Alternative: Set Chrome path (if Brave not available)
+# [Environment]::SetEnvironmentVariable("CHROME_PATH", "C:\Program Files\Google\Chrome\Application\chrome.exe", "User")
+
+echo "✅ Environment variables set successfully!"
+```
+
+**Step 5: Test MCP Server**
+```powershell
+# Test the MCP server directly
+npx brave-real-browser-mcp-server@latest --help
+
+# Test with Claude Desktop (restart Claude first)
+echo "🔄 Restart Claude Desktop and test with: 'Initialize a browser and navigate to google.com'"
+```
+
+#### Method 2: Quick Setup (One-liner)
+```powershell
+# Complete Windows setup in one command
+iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/codeiva4u/Brave-Real-Browser-Mcp-Server/main/scripts/install-windows.ps1'))
+```
+
+### macOS Installation
+
+#### Method 1: Complete macOS Setup (Recommended)
+
+**Step 1: Install Node.js**
+```bash
+# Option 1: Download from nodejs.org
+# Visit: https://nodejs.org/
+
+# Option 2: Use Homebrew
+brew install node
+
+# Option 3: Use nvm (Node Version Manager)
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
+source ~/.bashrc
+nvm install node
+
+# Verify installation
+node --version
+npm --version
+```
+
+**Step 2: Install Brave Browser (Recommended)**
+```bash
+# Option 1: Download from brave.com
+# Visit: https://brave.com/download/
+
+# Option 2: Use Homebrew
+brew install --cask brave-browser
+
+# Option 3: Use Mac App Store
+# Search for "Brave Browser" in App Store
+
+# Verify installation
+"/Applications/Brave Browser.app/Contents/MacOS/Brave Browser" --version
+```
+
+**Step 3: Setup Claude Desktop MCP Configuration**
+```bash
+# Create Claude config directory
+mkdir -p ~/"Library/Application Support/Claude"
+
+# Create MCP configuration file
+cat << 'EOF' > ~/"Library/Application Support/Claude/claude_desktop_config.json"
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "npx",
+      "args": ["brave-real-browser-mcp-server@latest"]
+    }
+  }
+}
+EOF
+
+echo "✅ Claude Desktop MCP configuration created successfully!"
+echo "📁 Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json"
+```
+
+**Step 4: Setup Environment Variables (Optional)**
+```bash
+# Add to your shell profile (.bashrc, .zshrc, etc.)
+echo 'export BRAVE_PATH="/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"' >> ~/.zshrc
+
+# Alternative: Set Chrome path (if Brave not available)
+# echo 'export CHROME_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"' >> ~/.zshrc
+
+# Reload shell configuration
+source ~/.zshrc
+
+echo "✅ Environment variables set successfully!"
+```
+
+**Step 5: Test MCP Server**
+```bash
+# Test the MCP server directly
+npx brave-real-browser-mcp-server@latest --help
+
+# Test browser launch
+node -e "console.log('Testing browser paths:'); console.log('Brave:', process.env.BRAVE_PATH);"
+
+echo "🔄 Restart Claude Desktop and test with: 'Initialize a browser and navigate to google.com'"
+```
+
+#### Method 2: Quick Setup (One-liner)
+```bash
+# Complete macOS setup in one command
+curl -fsSL https://raw.githubusercontent.com/codeiva4u/Brave-Real-Browser-Mcp-Server/main/scripts/install-macos.sh | bash
+```
+
+### Linux Installation
+
+#### Method 1: Complete Linux Setup (Ubuntu/Debian)
+
+**Step 1: Install Node.js**
+```bash
+# Option 1: Using NodeSource repository (recommended)
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# Option 2: Using snap
+sudo snap install node --classic
+
+# Option 3: Using package manager
+sudo apt update
+sudo apt install -y nodejs npm
+
+# Verify installation
+node --version
+npm --version
+```
+
+**Step 2: Install Brave Browser (Recommended)**
+```bash
+# Install Brave Browser
+sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
+
+echo "deb [signed-by=/usr/share/keyrings/brave-browser-archive-keyring.gpg] https://brave-browser-apt-release.s3.brave.com/ stable main" | sudo tee /etc/apt/sources.list.d/brave-browser-release.list
+
+sudo apt update
+sudo apt install -y brave-browser
+
+# Install dependencies for headless operation
+sudo apt-get install -y xvfb
+
+# Verify installation
+brave-browser --version
+```
+
+**Step 3: Setup Claude Desktop MCP Configuration**
+```bash
+# Create Claude config directory
+mkdir -p ~/.config/Claude
+
+# Create MCP configuration file
+cat << 'EOF' > ~/.config/Claude/claude_desktop_config.json
+{
+  "mcpServers": {
+    "brave-real-browser": {
+      "command": "npx",
+      "args": ["brave-real-browser-mcp-server@latest"]
+    }
+  }
+}
+EOF
+
+echo "✅ Claude Desktop MCP configuration created successfully!"
+echo "📁 Config file location: ~/.config/Claude/claude_desktop_config.json"
+```
+
+**Step 4: Setup Environment Variables**
+```bash
+# Add to your shell profile
+echo 'export BRAVE_PATH="/usr/bin/brave-browser"' >> ~/.bashrc
+echo 'export DISPLAY=:99' >> ~/.bashrc  # For headless operation
+
+# Alternative browser paths
+# echo 'export CHROME_PATH="/usr/bin/google-chrome"' >> ~/.bashrc
+# echo 'export CHROME_PATH="/usr/bin/chromium-browser"' >> ~/.bashrc
+
+# Reload shell configuration
+source ~/.bashrc
+
+echo "✅ Environment variables set successfully!"
+```
+
+**Step 5: Setup Headless Display (For Server Usage)**
+```bash
+# Start virtual display for headless operation
+sudo apt-get install -y xvfb
+
+# Create xvfb service (optional)
+sudo tee /etc/systemd/system/xvfb.service << 'EOF'
+[Unit]
+Description=X Virtual Frame Buffer Service
+After=network.target
+
+[Service]
+ExecStart=/usr/bin/Xvfb :99 -screen 0 1024x768x24
+Restart=on-failure
+RestartSec=2
+User=nobody
+Group=nogroup
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# Enable and start xvfb service
+sudo systemctl enable xvfb
+sudo systemctl start xvfb
+
+echo "✅ Headless display configured successfully!"
+```
+
+**Step 6: Test MCP Server**
+```bash
+# Test the MCP server directly
+npx brave-real-browser-mcp-server@latest --help
+
+# Test headless operation
+export DISPLAY=:99
+node -e "console.log('Testing browser paths:'); console.log('Brave:', process.env.BRAVE_PATH); console.log('Display:', process.env.DISPLAY);"
+
+# Test browser launch
+echo "🔄 Testing browser launch..."
+timeout 10s brave-browser --headless --dump-dom --disable-gpu https://google.com > /dev/null && echo "✅ Browser test successful!" || echo "❌ Browser test failed"
+
+echo "🔄 Restart Claude Desktop and test with: 'Initialize a browser and navigate to google.com'"
+```
+
+#### Method 2: CentOS/RHEL/Fedora Setup
+```bash
+# Install Node.js
+curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
+sudo yum install -y nodejs
+
+# Install Brave Browser
+sudo dnf install dnf-plugins-core
+sudo dnf config-manager --add-repo https://brave-browser-rpm-release.s3.brave.com/x86_64/
+sudo rpm --import https://brave-browser-rpm-release.s3.brave.com/brave-core.asc
+sudo dnf install brave-browser
+
+# Continue with steps 3-6 from Ubuntu setup above
+```
+
+#### Method 3: Quick Setup (One-liner for Ubuntu/Debian)
+```bash
+# Complete Linux setup in one command
+curl -fsSL https://raw.githubusercontent.com/codeiva4u/Brave-Real-Browser-Mcp-Server/main/scripts/install-linux.sh | bash
+```
+
+### Post-Installation Verification
+
+**Test MCP Server on All Platforms:**
+```bash
+# 1. Test Node.js and npm
+node --version && npm --version
+
+# 2. Test MCP server installation
+npx brave-real-browser-mcp-server@latest --version
+
+# 3. Test browser availability
+# Windows: & "C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe" --version
+# macOS: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser" --version  
+# Linux: brave-browser --version
+
+# 4. Verify MCP configuration
+# Check if claude_desktop_config.json exists and contains brave-real-browser server
+
+# 5. Test with Claude Desktop
+# Restart Claude Desktop completely
+# Try: "Initialize a browser and navigate to example.com, then get the page title"
+```
+
 ## 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.
@@ -213,7 +579,7 @@ The configuration below uses `npx` to automatically download and run the latest
 
 ### With Claude Code CLI
 
-Claude Code CLI offers multiple convenient methods to add the puppeteer-real-browser MCP server. Choose the method that best fits your workflow:
+Claude Code CLI offers multiple convenient methods to add the brave-real-browser MCP server. Choose the method that best fits your workflow:
 
 #### Method 1: Quick Setup (Recommended)
 
@@ -230,9 +596,16 @@ This command:
 
 #### Method 2: Add with Environment Variables
 
-If you need to configure proxy settings or custom Chrome paths:
+If you need to configure proxy settings or custom browser paths:
 
 ```bash
+# For Brave Browser (recommended)
+claude mcp add brave-real-browser \
+  -e BRAVE_PATH="/path/to/brave" \
+  -e PROXY_URL="http://proxy:8080" \
+  -- npx brave-real-browser-mcp-server@latest
+
+# Alternative for Chrome (if Brave not available)
 claude mcp add brave-real-browser \
   -e CHROME_PATH="/path/to/chrome" \
   -e PROXY_URL="http://proxy:8080" \
@@ -256,6 +629,18 @@ claude mcp add brave-real-browser -s project -- npx brave-real-browser-mcp-serve
 For advanced users who want precise control:
 
 ```bash
+# For Brave Browser (recommended)
+claude mcp add-json brave-real-browser '{
+  "type": "stdio",
+  "command": "npx",
+  "args": ["brave-real-browser-mcp-server@latest"],
+  "env": {
+    "BRAVE_PATH": "/path/to/brave",
+    "PROXY_URL": "http://proxy:8080"
+  }
+}'
+
+# Alternative for Chrome (if Brave not available)
 claude mcp add-json brave-real-browser '{
   "type": "stdio",
   "command": "npx",
@@ -298,7 +683,7 @@ After adding the server:
 
 - **Automatic Updates**: Using `@latest` ensures you get bug fixes and improvements
 - **No Installation**: npx handles downloading and running automatically  
-- **Environment Variables**: Easy configuration of proxies, Chrome paths, etc.
+- **Environment Variables**: Easy configuration of proxies, Brave/Chrome paths, etc.
 - **Scope Control**: Choose where the server is available (local/project/user)
 - **Team Sharing**: Project scope allows sharing configurations with teammates
 - **Status Monitoring**: Built-in `/mcp` command for server health checks
@@ -336,7 +721,7 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 
 > **Important:** Just like Claude Desktop, Cursor will use `npx` to automatically download and run the server. You don't need to install anything with npm!
 
-**Windows-Specific Configuration (if experiencing Chrome path issues):**
+**Windows-Specific Configuration (Brave Browser Recommended):**
 ```json
 {
   "mcpServers": {
@@ -344,16 +729,14 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
       "command": "npx",
       "args": ["brave-real-browser-mcp-server@latest"],
       "env": {
-        "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
+        "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
       }
     }
   }
 }
 ```
 
-> **Note**: Browser options like headless mode should be configured when initializing the browser through the `browser_init` tool, not via environment variables.
-
-**Advanced Configuration with Custom Chrome Path:**
+**Alternative Chrome Configuration (if Brave not available):**
 ```json
 {
   "mcpServers": {
@@ -368,36 +751,60 @@ Cursor IDE uses the same npx approach - no installation needed! Here are the set
 }
 ```
 
+> **Note**: Browser options like headless mode should be configured when initializing the browser through the `browser_init` tool, not via environment variables.
+
 > **Note**: Proxy settings and browser options should be configured when asking Claude to initialize the browser using the `browser_init` tool.
 
-#### Platform-Specific Chrome Paths for Cursor IDE
+#### Platform-Specific Browser Paths for Cursor IDE
 
-If Chrome auto-detection fails, you can specify the Chrome path using the `CHROME_PATH` environment variable:
+If browser auto-detection fails, you can specify the browser path using environment variables:
 
-**Windows:**
+**Windows (Brave Browser Recommended):**
+```json
+"env": {
+  "BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"
+}
+```
+Alternative Brave paths:
+- `"C:/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe"`
+- `"%LOCALAPPDATA%/BraveSoftware/Brave-Browser/Application/brave.exe"`
+
+**Windows (Chrome Alternative - if Brave not available):**
 ```json
 "env": {
   "CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"
 }
 ```
-Alternative Windows paths:
+Alternative Chrome paths (use only if Brave is not installed):
 - `"C:/Program Files (x86)/Google/Chrome/Application/chrome.exe"`
 - `"%LOCALAPPDATA%/Google/Chrome/Application/chrome.exe"`
 
-**macOS:**
+**macOS (Brave Browser Recommended):**
+```json
+"env": {
+  "BRAVE_PATH": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+}
+```
+**macOS (Chrome Alternative - if Brave not available):**
 ```json
 "env": {
   "CHROME_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
 }
 ```
 
-**Linux:**
+**Linux (Brave Browser Recommended):**
+```json
+"env": {
+  "BRAVE_PATH": "/usr/bin/brave-browser"
+}
+```
+**Linux (Chrome Alternative - if Brave not available):**
 ```json
 "env": {
   "CHROME_PATH": "/usr/bin/google-chrome"
 }
 ```
-Alternative Linux paths: `/usr/bin/chromium-browser`, `/snap/bin/chromium`
+Alternative Chrome paths (use only if Brave is not installed): `/usr/bin/chromium-browser`, `/snap/bin/chromium`
 
 
 #### Testing Cursor IDE Setup
@@ -422,9 +829,10 @@ If successful, you should see:
    - Ensure Node.js 18+ is installed
 
 2. **"Browser failed to launch" on Windows**
-   - Add explicit Chrome path in `executablePath`
+   - Add explicit Brave browser path: `"BRAVE_PATH": "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe"`
+   - Alternative (if Brave not available): Add Chrome path: `"CHROME_PATH": "C:/Program Files/Google/Chrome/Application/chrome.exe"`
    - Try running Cursor IDE as Administrator
-   - Check Windows Defender isn't blocking Chrome
+   - Check Windows Defender isn't blocking browser
 
 3. **"Permission denied"**
    - Use `sudo npm install -g brave-real-browser-mcp-server` on Linux/Mac
@@ -581,7 +989,7 @@ The server includes basic support for solving common captcha types:
 - Cloudflare Turnstile
 
 Note that captcha solving capabilities depend on the underlying
-puppeteer-real-browser implementation.
+brave-real-browser implementation.
 
 ## Configuration
 
@@ -881,7 +1289,7 @@ Version 1.3.0 includes comprehensive fixes for the `connect ECONNREFUSED 127.0.0
    
    - **MCP Server Status**:
      - Use `/mcp` command in Claude Code to check server status
-     - Look for the "puppeteer-real-browser" server in the list
+     - Look for the "brave-real-browser" server in the list
      - Check if server status shows "connected" or error messages
    
    - **Environment Variables**:
@@ -1003,10 +1411,10 @@ A: Yes, set `headless: true` in browser_init options.
 A: Currently supports one browser instance. Close the current one before starting a new one.
 
 **Q: What captchas can it solve?**
-A: Supports reCAPTCHA, hCaptcha, and Cloudflare Turnstile through puppeteer-real-browser.
+A: Supports reCAPTCHA, hCaptcha, and Cloudflare Turnstile through brave-real-browser.
 
 **Q: Is this detectable by websites?**
-A: puppeteer-real-browser includes anti-detection features, but no solution is 100% undetectable.
+A: brave-real-browser includes anti-detection features, but no solution is 100% undetectable.
 
 **Q: Can I use custom Chrome extensions?**
 A: Yes, through the `plugins` option in browser_init.
@@ -1075,7 +1483,7 @@ DEBUG=true npm run dev
 ### Getting Help
 
 If you're still having issues:
-1. Check the [GitHub Issues](https://github.com/withLinda/brave-real-browser-mcp-server/issues)
+1. Check the [GitHub Issues](https://github.com/your-organization/brave-real-browser-mcp-server/issues)
 2. Create a new issue with:
    - Your operating system
    - Node.js version (`node --version`)
@@ -1197,9 +1605,9 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Acknowledgments
 
-This MCP server is based on the excellent [puppeteer-real-browser](https://github.com/ZFC-Digital/puppeteer-real-browser) library by ZFC-Digital.
+This MCP server is based on the excellent [brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser) library by ZFC-Digital.
 
-**Thank you** to the puppeteer-real-browser team for creating such a powerful and detection-resistant browser automation solution!
+**Thank you** to the brave-real-browser team for creating such a powerful and detection-resistant browser automation solution!
 
-- GitHub: [https://github.com/ZFC-Digital/puppeteer-real-browser](https://github.com/ZFC-Digital/puppeteer-real-browser)
-- npm: [https://www.npmjs.com/package/puppeteer-real-browser](https://www.npmjs.com/package/puppeteer-real-browser)
+- GitHub: [https://github.com/ZFC-Digital/brave-real-browser](https://github.com/ZFC-Digital/brave-real-browser)
+- npm: [https://www.npmjs.com/package/brave-real-browser](https://www.npmjs.com/package/brave-real-browser)

package/dist/browser-manager.js

@@ -1,4 +1,4 @@
-import { connect } from 'puppeteer-real-browser';
+import { connect } from 'brave-real-browser';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as net from 'net';