brave-real-browser-mcp-server 2.14.15 → 2.15.1

package/README.md

@@ -6,13 +6,13 @@
 
 ![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-108-purple.svg)
+![Tools](https://img.shields.io/badge/tools-78-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 | 108+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
+**सभी AI IDEs के लिए Universal MCP Server | 78+ Tools | Browser Automation | Web Scraping | CAPTCHA Solving**
 
-[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-108) | [IDE Configurations](#-ide-configurations)
+[Installation](#-installation) | [Quick Start](#-quick-start) | [Qoder AI Setup](#-qoder-ai---complete-integration-guide) | [Tools](#-available-tools-78) | [IDE Configurations](#-ide-configurations)
 
 </div>
 
@@ -23,7 +23,7 @@
 **Brave Real Browser MCP Server** एक powerful automation tool है जो:
 
 - ✅ **20+ AI IDEs में काम करता है** (Antigravity, Warp AI, Zed, Cursor, Claude, Windsurf, Cline, Qoder AI, etc.)
-- ✅ **108+ Automation Tools** - Browser control, scraping, CAPTCHA solving, video extraction
+- ✅ **78+ 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
@@ -189,7 +189,7 @@ npm install -g brave-real-browser-mcp-server@latest
 
 ---
 
-## 🛠️ Available Tools (108)
+## 🛠️ Available Tools (78)
 
 ### 🌐 Browser Management (2 tools)
 
@@ -262,24 +262,18 @@ npm install -g brave-real-browser-mcp-server@latest
 | Tool                            | Description                              |
 | ------------------------------- | ---------------------------------------- |
 | `video_link_finder`             | Find video URLs                          |
-| `video_download_page`           | Navigate to video download page          |
 | `video_download_button`         | Find video download buttons              |
 | `video_play_push_source`        | Get video play sources                   |
 | `video_play_button_click`       | Click video play button                  |
-| `url_redirect_trace_endpoints`  | Trace URL redirects                      |
-| `network_recording_finder`      | Find network recordings                  |
-| `network_recording_extractors`  | Extract network data                     |
-| `video_links_finders`           | Multiple video link finders              |
-| `videos_selectors`              | Video element selectors                  |
-| `link_process_extracts`         | Process and extract links                |
-| `video_link_finders_extracts`   | Advanced video link extraction           |
-| `video_download_button_finders` | Find all download buttons                |
 | `advanced_video_extraction`     | Advanced video extraction with ad-bypass |
 | `image_extractor_advanced`      | Advanced image extraction                |
 | `video_source_extractor`        | Extract video source URLs                |
 | `video_player_extractor`        | Extract video player info                |
 | `video_player_hoster_finder`    | Find video hosting platform              |
 | `original_video_hoster_finder`  | Find original video source               |
+| `stream_detector`               | Detect HLS/DASH streams                  |
+| `redirect_tracer`               | Trace URL redirects                      |
+| `video_download_link_finder`    | Find direct download links               |
 
 ### 🔐 CAPTCHA & Security (4 tools)
 
@@ -381,12 +375,11 @@ npm install -g brave-real-browser-mcp-server@latest
 | `deobfuscate_js`             | Deobfuscate JavaScript      |
 | `multi_layer_redirect_trace` | Trace multi-layer redirects |
 | `ad_protection_detector`     | Detect ad protection        |
-| `url_redirect_tracer`        | Trace URL redirects         |
 
 
 ## 🔧 Environment Variables
 
-## 🔧 Environment Variables
+
 
 You can configure the server using the local `.env` file directly.
 
@@ -428,6 +421,6 @@ MIT License - See LICENSE file for details.
 
 <div align="center">
 
-**🌟 108 Tools | 15+ AI IDEs | MCP Protocol | Universal Support 🌟**
+**🌟 78 Tools | 15+ AI IDEs | MCP Protocol | Universal Support 🌟**
 
 **Made with ❤️ for the AI Development Community**

package/dist/handlers/advanced-video-media-handlers.js

@@ -105,7 +105,7 @@ export async function handleVideoDownloadLinkFinder(args) {
 // --- Implementation of missing "Ghost" handlers required by index.ts ---
 // Aliases or specific implementations
 export const handleVideoLinkFinder = handleVideoDownloadLinkFinder;
-export async function handleVideoDownloadPage(args) {
+export async function handleVideoDownloadButton(args) {
     // Basic implementation trying to find "Download" buttons contextually
     const page = getPageInstance();
     if (!page)
@@ -119,9 +119,6 @@ export async function handleVideoDownloadPage(args) {
     });
     return { content: [{ type: 'text', text: JSON.stringify(downloadProbability, null, 2) }] };
 }
-export async function handleVideoDownloadButton(args) {
-    return handleVideoDownloadPage(args);
-}
 export async function handleVideoPlayPushSource(args) {
     return { content: [{ type: 'text', text: "Video Play Push Source detected (Simulated)" }] };
 }
@@ -140,27 +137,3 @@ export async function handleVideoPlayButtonClick(args) {
     });
     return { content: [{ type: 'text', text: clicked ? "Clicked Play Button" : "No Play Button Found" }] };
 }
-export async function handleUrlRedirectTraceEndpoints(args) {
-    return handleRedirectTracer(args);
-}
-export async function handleNetworkRecordingFinder(args) {
-    return handleStreamDetector(args);
-}
-export async function handleNetworkRecordingExtractors(args) {
-    return handleStreamDetector(args);
-}
-export async function handleVideoLinksFinders(args) {
-    return handleVideoDownloadLinkFinder(args);
-}
-export async function handleVideosSelectors(args) {
-    return handleVideoSourceExtractor(args);
-}
-export async function handleLinkProcessExtracts(args) {
-    return { content: [{ type: 'text', text: "Link Process Extracts (Stub)" }] };
-}
-export async function handleVideoLinkFindersExtracts(args) {
-    return handleVideoDownloadLinkFinder(args);
-}
-export async function handleVideoDownloadButtonFinders(args) {
-    return handleVideoDownloadPage(args);
-}

package/dist/index.js

@@ -50,7 +50,7 @@ import { handleShadowDOMExtractor, handleCookieManager, handleFormAutoFill, hand
 // Import monitoring & reporting handlers
 import { handleProgressTracker, handleDataQualityMetrics, } from "./handlers/monitoring-reporting-handlers.js";
 // Import advanced video & media handlers
-import { handleVideoLinkFinder, handleVideoDownloadPage, handleVideoDownloadButton, handleVideoPlayPushSource, handleVideoPlayButtonClick, handleUrlRedirectTraceEndpoints, handleNetworkRecordingFinder, handleNetworkRecordingExtractors, handleVideoLinksFinders, handleVideosSelectors, handleLinkProcessExtracts, handleVideoLinkFindersExtracts, handleVideoDownloadButtonFinders, } from "./handlers/advanced-video-media-handlers.js";
+import { handleVideoLinkFinder, handleVideoDownloadButton, handleVideoPlayPushSource, handleVideoPlayButtonClick, } from "./handlers/advanced-video-media-handlers.js";
 // Import advanced extraction handlers (Ad-bypass & Obfuscation)
 import { handleAdvancedVideoExtraction, handleDeobfuscateJS, handleMultiLayerRedirectTrace, handleAdProtectionDetector, } from "./handlers/advanced-extraction-handlers.js";
 console.error("🔍 [DEBUG] All modules loaded successfully");
@@ -315,9 +315,6 @@ export async function executeToolByName(name, args) {
             case "video_link_finder":
                 result = await handleVideoLinkFinder(args || {});
                 break;
-            case "video_download_page":
-                result = await handleVideoDownloadPage(args || {});
-                break;
             case "video_download_button":
                 result = await handleVideoDownloadButton(args);
                 break;
@@ -327,30 +324,6 @@ export async function executeToolByName(name, args) {
             case "video_play_button_click":
                 result = await handleVideoPlayButtonClick(args || {});
                 break;
-            case "url_redirect_trace_endpoints":
-                result = await handleUrlRedirectTraceEndpoints(args);
-                break;
-            case "network_recording_finder":
-                result = await handleNetworkRecordingFinder(args || {});
-                break;
-            case "network_recording_extractors":
-                result = await handleNetworkRecordingExtractors(args || {});
-                break;
-            case "video_links_finders":
-                result = await handleVideoLinksFinders(args || {});
-                break;
-            case "videos_selectors":
-                result = await handleVideosSelectors(args || {});
-                break;
-            case "link_process_extracts":
-                result = await handleLinkProcessExtracts(args || {});
-                break;
-            case "video_link_finders_extracts":
-                result = await handleVideoLinkFindersExtracts(args || {});
-                break;
-            case "video_download_button_finders":
-                result = await handleVideoDownloadButtonFinders(args || {});
-                break;
             // Advanced Extraction Tools (Ad-Bypass & Obfuscation)
             case "advanced_video_extraction":
                 result = await handleAdvancedVideoExtraction(args || {});

package/dist/mcp-server.js

@@ -17,7 +17,7 @@ import { handleHtmlToText, handleDuplicateRemover } from './handlers/data-transf
 import { handleConsistencyChecker } from './handlers/data-quality-handlers.js';
 import { handleSmartSelectorGenerator, handleContentClassification, handleSentimentAnalysis, handleSummaryGenerator, handleTranslationSupport } from './handlers/ai-powered-handlers.js';
 import { handleKeywordSearch, handleRegexPatternMatcher, handleXPathSupport, handleAdvancedCSSSelectors, handleVisualElementFinder } from './handlers/search-filter-handlers.js';
-import { handleVideoSourceExtractor, handleVideoPlayerFinder, handleStreamDetector, handleRedirectTracer, handleVideoDownloadLinkFinder } from './handlers/advanced-video-media-handlers.js';
+import { handleVideoSourceExtractor, handleVideoPlayerFinder, handleStreamDetector, handleRedirectTracer } from './handlers/advanced-video-media-handlers.js';
 import { handleOCREngine, handleAudioCaptchaSolver, handlePuzzleCaptchaHandler } from './handlers/captcha-handlers.js';
 import { handleAdvancedVideoExtraction, handleDeobfuscateJS, handleMultiLayerRedirectTrace, handleAdProtectionDetector } from './handlers/advanced-extraction-handlers.js';
 export async function createMcpServer() {
@@ -209,9 +209,6 @@ export async function createMcpServer() {
                 case TOOL_NAMES.REDIRECT_TRACER:
                     result = await handleRedirectTracer(args);
                     break;
-                case TOOL_NAMES.VIDEO_DOWNLOAD_LINK_FINDER:
-                    result = await handleVideoDownloadLinkFinder(args);
-                    break;
                 // Phase 4: Captcha & Security
                 case TOOL_NAMES.OCR_ENGINE:
                     result = await handleOCREngine(args);

package/dist/tool-definitions.js

@@ -1003,14 +1003,6 @@ export const TOOLS = [
             },
         },
     },
-    {
-        name: 'video_download_page',
-        description: 'Detect and analyze video download pages',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
     {
         name: 'video_download_button',
         description: 'Find and interact with video download buttons',
@@ -1040,80 +1032,6 @@ export const TOOLS = [
             },
         },
     },
-    {
-        name: 'url_redirect_trace_endpoints',
-        description: 'Trace all URL redirect endpoints',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                url: { type: 'string' },
-            },
-            required: ['url'],
-        },
-    },
-    {
-        name: 'network_recording_finder',
-        description: 'Find and analyze network recordings',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                duration: { type: 'number', default: 10000 },
-                filterType: { type: 'string', enum: ['video', 'audio', 'media'], default: 'video' },
-            },
-        },
-    },
-    {
-        name: 'network_recording_extractors',
-        description: 'Extract data from network recordings',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                duration: { type: 'number', default: 10000 },
-            },
-        },
-    },
-    {
-        name: 'video_links_finders',
-        description: 'Advanced video link detection',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'videos_selectors',
-        description: 'Get all video-related selectors',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'link_process_extracts',
-        description: 'Process and extract links with categorization',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                processType: { type: 'string', enum: ['all', 'video', 'download', 'external'], default: 'all' },
-            },
-        },
-    },
-    {
-        name: 'video_link_finders_extracts',
-        description: 'Extract video links with complete metadata',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'video_download_button_finders',
-        description: 'Find all video download buttons on page',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
     // Advanced Extraction Tools (Ad-Bypass & Obfuscation)
     {
         name: 'advanced_video_extraction',
@@ -1314,7 +1232,6 @@ export const TOOL_NAMES = {
     VIDEO_PLAYER_FINDER: 'video_player_finder',
     STREAM_DETECTOR: 'stream_detector',
     REDIRECT_TRACER: 'redirect_tracer',
-    VIDEO_DOWNLOAD_LINK_FINDER: 'video_download_link_finder',
     // Search & Filter Tools
     KEYWORD_SEARCH: 'keyword_search',
     REGEX_PATTERN_MATCHER: 'regex_pattern_matcher',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.14.15",
+  "version": "2.15.1",
   "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",
@@ -34,7 +34,7 @@
     "test:brave:cleanup": "taskkill /F /IM brave.exe || pkill -f brave || true"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.3",
+    "@modelcontextprotocol/sdk": "^1.25.0",
     "@types/turndown": "^5.0.6",
     "ajv": "^8.12.0",
     "axios": "^1.6.5",

package/scripts/setup-brave.cjs

@@ -0,0 +1,171 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync, exec } = require('child_process');
+const https = require('https');
+
+// Colors for console output
+const colors = {
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+    cyan: "\x1b[36m"
+};
+
+function log(message, type = 'info') {
+    const timestamp = new Date().toISOString();
+    let color = colors.reset;
+    if (type === 'success') color = colors.green;
+    if (type === 'warn') color = colors.yellow;
+    if (type === 'error') color = colors.red;
+    if (type === 'info') color = colors.cyan;
+    console.log(`${color}[${type.toUpperCase()}] ${message}${colors.reset}`);
+}
+
+const platform = os.platform();
+
+// Define standard paths including the user's specific request
+const bravePaths = {
+    win32: [
+        'C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe', // User's requested primary path
+        'C:\\Program Files (x86)\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
+        path.join(os.homedir(), 'AppData', 'Local', 'BraveSoftware', 'Brave-Browser', 'Application', 'brave.exe')
+    ],
+    darwin: [
+        '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser'
+    ],
+    linux: [
+        '/usr/bin/brave-browser',
+        '/usr/bin/brave',
+        '/snap/bin/brave'
+    ]
+};
+
+async function checkBraveInstallation() {
+    log("Checking for Brave Browser installation...", 'info');
+    
+    let foundPath = null;
+    const pathsToCheck = bravePaths[platform] || [];
+
+    for (const p of pathsToCheck) {
+        if (fs.existsSync(p)) {
+            foundPath = p;
+            break;
+        }
+    }
+
+    if (foundPath) {
+        log(`Brave Browser found at: ${foundPath}`, 'success');
+        updateEnvFile(foundPath);
+        return true;
+    } else {
+        log("Brave Browser not found in standard locations.", 'warn');
+        return false;
+    }
+}
+
+function updateEnvFile(bravePath) {
+    const envPath = path.join(__dirname, '..', '.env');
+    try {
+        let envContent = '';
+        if (fs.existsSync(envPath)) {
+            envContent = fs.readFileSync(envPath, 'utf8');
+        } else {
+             // Create from example if possible, or just start empty
+             const examplePath = path.join(__dirname, '..', '.env.example');
+             if(fs.existsSync(examplePath)) {
+                envContent = fs.readFileSync(examplePath, 'utf8');
+             }
+        }
+
+        // Check if BRAVE_PATH is already set
+        if (envContent.includes('BRAVE_PATH=')) {
+             // Replace existing
+             const newContent = envContent.replace(/^BRAVE_PATH=.*$/m, `BRAVE_PATH=${bravePath}`);
+             if (newContent !== envContent) {
+                 fs.writeFileSync(envPath, newContent);
+                 log("Updated .env with detected Brave path.", 'success');
+             } else {
+                 log(".env already has a BRAVE_PATH set (or format differs).", 'info');
+             }
+        } else {
+            // Append
+            fs.appendFileSync(envPath, `\nBRAVE_PATH=${bravePath}\n`);
+            log("Appended BRAVE_PATH to .env.", 'success');
+        }
+    } catch (err) {
+        log(`Failed to update .env: ${err.message}`, 'error');
+    }
+}
+
+async function installBrave() {
+    log("Attempting to install Brave Browser...", 'info');
+    
+    if (platform === 'win32') {
+        const installerUrl = 'https://laptop-updates.brave.com/latest/winx64'; // Standard stub installer
+        const installerPath = path.join(os.tmpdir(), 'BraveBrowserSetup.exe');
+        
+        try {
+            await downloadFile(installerUrl, installerPath);
+            log(`Installer downloaded to ${installerPath}`, 'success');
+            log("Running installer... Please follow the prompts if any appear.", 'info');
+            
+            // Run installer
+            // /silent /install are common flags for Chromium based browsers.
+            // But we use start to let it run interactively if needed, or silent if possible.
+            // The standard stub installer usually just runs.
+            exec(`"${installerPath}"`, (error, stdout, stderr) => {
+                if (error) {
+                    log(`Installer execution failed: ${error.message}`, 'error');
+                } else {
+                    log("Installer started. Please complete the installation.", 'success');
+                }
+            });
+
+        } catch (err) {
+            log(`Failed to download/run installer: ${err.message}`, 'error');
+            log("Please install Brave manually from https://brave.com/download/", 'warn');
+        }
+    } else if (platform === 'darwin') {
+        log("Automatic installation on macOS is complex. Opening download page...", 'info');
+        exec('open https://brave.com/download/');
+    } else if (platform === 'linux') {
+        log("Please install Brave using your package manager (apt, dnf, snap, etc.).", 'info');
+        console.log("Visit: https://brave.com/linux/");
+    } else {
+        log(`Unsupported platform for auto-install: ${platform}`, 'error');
+    }
+}
+
+function downloadFile(url, dest) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode !== 200) {
+                 reject(new Error(`Failed to download: Status Code ${response.statusCode}`));
+                 return;
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close(resolve);
+            });
+        }).on('error', (err) => {
+            fs.unlink(dest, () => {}); // Delete the file async. (But we don't check result)
+            reject(err);
+        });
+    });
+}
+
+async function main() {
+    const isInstalled = await checkBraveInstallation();
+    if (!isInstalled) {
+        await installBrave();
+    }
+}
+
+main().catch(err => {
+    console.error("Setup script failed:", err);
+    process.exit(0); 
+});