brave-real-browser-mcp-server 2.21.8 → 2.23.0

package/README.md

@@ -1,17 +1,13 @@
 # Brave Real Browser MCP Server
 
-> **AI assistants को powerful, detection-resistant browser automation capabilities देता है**
+> **AI assistants के लिए powerful, anti-detection browser automation - Unified MCP+LSP+SSE ecosystem**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://img.shields.io/npm/v/brave-real-browser-mcp-server.svg)](https://www.npmjs.com/package/brave-real-browser-mcp-server)
 
 ## 🚀 Quick Start
 
-### Step 1: Configure Claude Desktop / Cursor / Gemini
-
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`  
-**Mac:** `~/Library/Application Support/Claude/`  
-**Linux:** `~/.config/Claude/`
+### Option 1: NPX (Recommended for AI IDEs)
 
 ```json
 {
@@ -24,127 +20,182 @@
 }
 ```
 
-### Step 2: Restart your AI assistant
+**Config locations:**
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **Mac:** `~/Library/Application Support/Claude/`
+- **Linux:** `~/.config/Claude/`
+
+### Option 2: Unified Server (Full Features)
 
-### Step 3: Test it!
-> "Initialize a browser and navigate to google.com, then get the page content"
+```bash
+npm run dev
+```
 
 ---
 
 ## ✨ Features
 
-- **Stealth by default** - Anti-detection features built-in
-- **Brave Browser auto-detection** - No manual path configuration needed
-- **33 powerful tools** - Complete browser automation toolkit
-- **Captcha handling** - reCAPTCHA, hCaptcha, Turnstile support
-- **Proxy support** - Built-in proxy configuration
-- **uBlock Origin** - Ad blocking enabled by default
+| Feature | Description |
+|---------|-------------|
+| **33 MCP Tools** | Complete browser automation toolkit |
+| **Unified Server** | MCP + SSE + LSP in one command |
+| **Stealth Mode** | 50+ anti-detection features |
+| **Captcha Solving** | reCAPTCHA, hCaptcha, Turnstile |
+| **Brave Browser** | Auto-detection, uBlock Origin built-in |
+| **TypeScript Analyzer** | Full Compiler API integration |
+| **Real-time Streaming** | SSE for live progress updates |
+| **Auto-Sync** | SharedEventBus connects all protocols |
 
 ---
 
-## 🛠️ Available Tools (33)
+## 🌐 Unified MCP+LSP+SSE Ecosystem
 
-### Core Browser (4)
-| Tool | Description |
-|------|-------------|
-| `browser_init` | Initialize stealth browser with anti-detection |
-| `navigate` | Navigate to any URL |
-| `get_content` | Extract page content (HTML/text) |
-| `browser_close` | Close browser instance |
+**एक command से सब active:**
 
-### Interaction (4)
-| Tool | Description |
-|------|-------------|
-| `click` | Click on elements |
-| `type` | Type text into inputs |
-| `wait` | Wait for conditions |
-| `press_key` | Simulate keyboard |
+```bash
+npm run dev
+```
 
-### Element Discovery (4)
-| Tool | Description |
-|------|-------------|
-| `find_element` | Find elements (text, CSS, XPath, AI-powered) |
-| `find_element_advanced` | Advanced element finding |
-| `smart_selector_generator` | AI-powered selector generation |
-| `batch_element_scraper` | Scrape lists of elements |
+### Output:
+```
+🦁 Brave Real Browser - Unified Server v2.22.0
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📡 HTTP Server: http://localhost:3000
+
+🛠️  Available MCP Tools:
+   🚀 browser_init    🔴 browser_close   🌐 navigate
+   📄 get_content     🔍 find_element    🖱️ click
+   ⌨️ type           🤖 solve_captcha   🎬 media_extractor
+   ... and 24 more tools
+
+🔗 SharedEventBus: Auto-syncing MCP ↔ LSP ↔ SSE
+📋 Total: 33 MCP tools | TypeScript Analyzer Active
+✅ Ready! All protocols unified and auto-synced.
+```
 
-### Content Extraction (5)
-| Tool | Description |
-|------|-------------|
-| `save_content_as_markdown` | Save page as markdown |
-| `search_content` | Search patterns in page |
-| `extract_json` | Extract embedded JSON |
-| `scrape_meta_tags` | Extract meta tags |
-| `extract_schema` | Extract Schema.org data |
+### All Endpoints:
+
+| Category | Endpoint | Purpose |
+|----------|----------|---------|
+| **MCP** | `POST /mcp` | MCP over HTTP |
+| **MCP** | `GET /mcp/sse` | SSE real-time streaming |
+| **MCP** | `POST /mcp/message` | SSE message handler |
+| **LSP** | `POST /lsp/completion` | Autocomplete |
+| **LSP** | `POST /lsp/hover` | Hover documentation |
+| **LSP** | `POST /lsp/analyze` | TypeScript analysis |
+| **LSP** | `POST /lsp/definition` | Go to definition |
+| **LSP** | `POST /lsp/references` | Find references |
+| **Other** | `GET /health` | Health check |
+| **Other** | `GET /events` | Event bus stats |
 
-### Navigation (3)
-| Tool | Description |
-|------|-------------|
-| `breadcrumb_navigator` | Navigate via breadcrumbs |
-| `redirect_tracer` | Trace URL redirects |
-| `m3u8_parser` | Parse HLS/m3u8 streams |
+---
 
-### Network & API (4)
+## 🛠️ All 33 MCP Tools
+
+### Browser Management
 | Tool | Description |
 |------|-------------|
-| `network_recorder` | Record network traffic |
-| `api_finder` | Discover hidden APIs |
-| `ajax_content_waiter` | Wait for AJAX content |
-| `deep_analysis` | Comprehensive page analysis |
+| `browser_init` | Initialize Brave browser with stealth |
+| `browser_close` | Close browser instance |
 
-### Media (3)
+### Navigation
 | Tool | Description |
 |------|-------------|
-| `media_extractor` | Extract video/audio |
-| `file_downloader` | Download files |
-| `element_screenshot` | Screenshot elements |
+| `navigate` | Navigate to URL |
+| `wait` | Wait for conditions |
 
-### Streaming & Download (3)
+### Content
 | Tool | Description |
 |------|-------------|
-| `iframe_handler` | Extract from nested iframes |
-| `popup_handler` | Handle popups and new tabs |
-| `stream_extractor` | Extract direct download URLs |
+| `get_content` | Get page HTML/text |
+| `find_element` | Find by selector/text/AI |
+| `save_content_as_markdown` | Save as markdown file |
 
-### Utility (3)
+### Interaction
 | Tool | Description |
 |------|-------------|
-| `link_harvester` | Harvest all links |
+| `click` | Click on element |
+| `type` | Type text into input |
+| `press_key` | Keyboard press |
 | `random_scroll` | Natural scrolling |
 | `solve_captcha` | Solve CAPTCHAs |
 
----
-
-## ⚙️ Browser Options
+### Media Extraction
+| Tool | Description |
+|------|-------------|
+| `media_extractor` | Extract video/audio |
+| `m3u8_parser` | Parse HLS streams |
+| `stream_extractor` | Direct download URLs |
 
-```json
-{
-  "headless": false,
-  "proxy": "http://proxy:8080",
-  "disableXvfb": false
-}
-```
+### Advanced
+| Tool | Description |
+|------|-------------|
+| `search_content` | Search patterns |
+| `extract_json` | Extract embedded JSON |
+| `scrape_meta_tags` | Meta/OG tags |
+| `deep_analysis` | Full page analysis |
+| `network_recorder` | Record traffic |
+| `api_finder` | Discover APIs |
+| `ajax_content_waiter` | Wait for AJAX |
+| `link_harvester` | Harvest links |
+| `batch_element_scraper` | Batch scrape |
+| `extract_schema` | Schema.org data |
+| `element_screenshot` | Screenshot element |
+| `breadcrumb_navigator` | Navigate breadcrumbs |
+| `redirect_tracer` | Trace redirects |
+| `progress_tracker` | Track progress |
+| `cookie_manager` | Manage cookies |
+| `file_downloader` | Download files |
+| `iframe_handler` | Handle iframes |
+| `popup_handler` | Handle popups |
 
 ---
 
-## 🔧 Development
+## 📋 Commands
 
 ```bash
-# Clone
-git clone https://github.com/codeiva4u/Brave-Real-Browser-Mcp-Server.git
-cd Brave-Real-Browser-Mcp-Server
-
 # Install
 npm install
 
 # Build
 npm run build
 
-# Test
+# Development (Unified - Recommended!)
+npm run dev           # MCP + SSE + LSP on port 3000
+
+# Alternate modes
+npm run dev:stdio     # STDIO only (for AI IDEs)
+npm run dev:sse       # SSE standalone
+npm run dev:http      # HTTP Stream standalone
+
+# Production
+npm start             # Unified server
+npm run start:stdio   # STDIO mode
+
+# Tests
 npm test
+npm run test:e2e
+```
 
-# Run locally
-npm run dev
+---
+
+## ⚙️ Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_PORT` | `3000` | Server port |
+| `MCP_HOST` | `localhost` | Server host |
+| `DEBUG` | `false` | Debug logging |
+
+---
+
+## 🔧 Browser Options
+
+```json
+{
+  "headless": false,
+  "proxy": "http://proxy:8080"
+}
 ```
 
 ---
@@ -152,15 +203,23 @@ npm run dev
 ## 📋 Prerequisites
 
 - **Node.js** >= 18.0.0
-- **Brave Browser** (automatically detected)
-
-> **Note:** Brave Browser is automatically detected. No manual configuration needed!
+- **Brave Browser** (auto-detected)
 
 ---
 
-## 🤝 Contributing
+## 🐛 Troubleshooting
+
+### Port in use
+```bash
+MCP_PORT=3001 npm run dev
+```
+
+### Debug mode
+```bash
+DEBUG=true npm run dev
+```
 
-Contributions welcome! Please read our contributing guidelines.
+---
 
 ## 📄 License
 

package/dist/core-infrastructure.js

@@ -148,12 +148,19 @@ export function handleToolResponse(result, successMessage) {
 // MCP server configuration constants
 export const MCP_SERVER_CONFIG = {
     name: 'brave-real-browser-mcp-server',
-    version: '1.4.0',
+    version: '2.22.0',
     capabilities: {
         tools: {},
         resources: {},
         prompts: {},
     },
+    extendedCapabilities: {
+        streaming: true,
+        sessionManagement: true,
+        autoSync: true,
+        progressNotifications: true,
+        transports: ['stdio', 'sse', 'http-stream'],
+    },
 };
 // Process cleanup utilities
 export function setupProcessCleanup(cleanupCallback) {

package/dist/handlers/browser-handlers.js

@@ -1,16 +1,23 @@
 import { initializeBrowser, closeBrowser, getBrowserInstance, getPageInstance, getContentPriorityConfig, updateContentPriorityConfig } from '../browser-manager.js';
 import { withErrorHandling } from '../system-utils.js';
 import { validateWorkflow, recordExecution, workflowValidator } from '../workflow-validation.js';
-// Browser initialization handler
+import { getProgressNotifier } from '../transport/progress-notifier.js';
+// Browser initialization handler with real-time progress
 export async function handleBrowserInit(args) {
+    const progressNotifier = getProgressNotifier();
+    const progressToken = `browser-init-${Date.now()}`;
+    const tracker = progressNotifier.createTracker(progressToken);
     return await withWorkflowValidation('browser_init', args, async () => {
         return await withErrorHandling(async () => {
+            tracker.start(100, '🚀 Starting browser initialization...');
             // Update content priority configuration if provided
             if (args.contentPriority) {
+                tracker.setProgress(10, '⚙️ Applying content priority settings...');
                 updateContentPriorityConfig(args.contentPriority);
             }
             // Parse connectOption if it's a string
             if (typeof args.connectOption === 'string') {
+                tracker.setProgress(15, '📝 Parsing connection options...');
                 try {
                     args.connectOption = JSON.parse(args.connectOption);
                 }
@@ -19,7 +26,13 @@ export async function handleBrowserInit(args) {
                     args.connectOption = {};
                 }
             }
+            tracker.setProgress(20, '🔍 Detecting Brave Browser...');
+            tracker.setProgress(30, '🛡️ Applying anti-detection features...');
+            tracker.setProgress(40, '🔌 Loading stealth plugins...');
+            tracker.setProgress(50, '🚀 Launching browser...');
             await initializeBrowser(args);
+            tracker.setProgress(80, '📄 Creating new page...');
+            tracker.setProgress(90, '✅ Browser ready!');
             const config = getContentPriorityConfig();
             const configMessage = config.prioritizeContent
                 ? '\n\n💡 Content Priority Mode: get_content is prioritized for better reliability. Use get_content for page analysis instead of screenshots.'
@@ -29,6 +42,7 @@ export async function handleBrowserInit(args) {
                 '  • Then: Use get_content to analyze page content\n' +
                 '  • Finally: Use find_selector and interaction tools\n\n' +
                 '✅ Workflow validation is now active - prevents blind selector guessing';
+            tracker.complete('🎉 Browser initialized successfully');
             return {
                 content: [
                     {
@@ -40,13 +54,22 @@ export async function handleBrowserInit(args) {
         }, 'Failed to initialize browser');
     });
 }
-// Browser close handler
+// Browser close handler with real-time progress
 export async function handleBrowserClose() {
+    const progressNotifier = getProgressNotifier();
+    const progressToken = `browser-close-${Date.now()}`;
+    const tracker = progressNotifier.createTracker(progressToken);
     return await withWorkflowValidation('browser_close', {}, async () => {
         return await withErrorHandling(async () => {
+            tracker.start(100, '🔄 Closing browser...');
+            tracker.setProgress(20, '💾 Saving session state...');
+            tracker.setProgress(40, '🧹 Cleaning up processes...');
             await closeBrowser();
+            tracker.setProgress(70, '🔄 Resetting workflow state...');
             // Reset workflow state when browser is closed
             workflowValidator.reset();
+            tracker.setProgress(90, '✅ Browser closed!');
+            tracker.complete('🎉 Browser closed successfully');
             return {
                 content: [
                     {

package/dist/handlers/content-handlers.js

@@ -1,30 +1,41 @@
 import { getPageInstance } from '../browser-manager.js';
 import { withErrorHandling } from '../system-utils.js';
 import { validateWorkflow, recordExecution, workflowValidator } from '../workflow-validation.js';
-// Get content handler
+import { getProgressNotifier } from '../transport/progress-notifier.js';
+// Get content handler with real-time progress
 export async function handleGetContent(args) {
+    const progressNotifier = getProgressNotifier();
+    const progressToken = `get-content-${Date.now()}`;
+    const tracker = progressNotifier.createTracker(progressToken);
     return await withWorkflowValidation('get_content', args, async () => {
         return await withErrorHandling(async () => {
+            tracker.start(100, '📄 Starting content extraction...');
             const pageInstance = getPageInstance();
             if (!pageInstance) {
+                tracker.fail('Browser not initialized');
                 throw new Error('Browser not initialized. Call browser_init first.');
             }
             const { type = 'html', selector } = args;
             let content;
             if (selector) {
+                tracker.setProgress(20, `🔍 Finding element: ${selector}`);
                 // Get content from specific element
                 const element = await pageInstance.$(selector);
                 if (!element) {
+                    tracker.fail('Element not found');
                     throw new Error(`Element not found: ${selector}. Use find_selector to locate elements first.`);
                 }
+                tracker.setProgress(40, '📝 Extracting element content...');
                 if (type === 'text') {
                     content = await pageInstance.$eval(selector, (el) => el.innerText || el.textContent || '');
                 }
                 else {
                     content = await pageInstance.$eval(selector, (el) => el.outerHTML || '');
                 }
+                tracker.setProgress(70, `✅ Extracted ${content.length} characters from element`);
             }
             else {
+                tracker.setProgress(20, '📄 Extracting full page content...');
                 // Get full page content
                 if (type === 'text') {
                     content = await pageInstance.evaluate(() => document.body?.innerText || document.documentElement?.innerText || document.body?.textContent || '');
@@ -32,12 +43,15 @@ export async function handleGetContent(args) {
                 else {
                     content = await pageInstance.content();
                 }
+                tracker.setProgress(70, `✅ Extracted ${content.length} characters from page`);
             }
+            tracker.setProgress(90, '📋 Preparing response...');
             // Return content directly - LLM handles its own token limits
             const workflowMessage = '\n\n🔄 Workflow Status: Content analyzed\n' +
                 '  • Next step: Use find_selector to locate specific elements\n' +
                 '  • Then: Use interaction tools (click, type) for automation\n\n' +
                 '✅ Content available for element discovery and interactions';
+            tracker.complete(`🎉 Content extracted successfully (${content.length} chars)`);
             return {
                 content: [
                     {
@@ -49,17 +63,23 @@ export async function handleGetContent(args) {
         }, 'Failed to get page content');
     });
 }
-// Find selector handler
+// Find selector handler with real-time progress
 export async function handleFindSelector(args) {
+    const progressNotifier = getProgressNotifier();
+    const progressToken = `find-selector-${Date.now()}`;
+    const tracker = progressNotifier.createTracker(progressToken);
     return await withWorkflowValidation('find_selector', args, async () => {
         return await withErrorHandling(async () => {
+            tracker.start(100, '🔍 Starting element search...');
             const pageInstance = getPageInstance();
             if (!pageInstance) {
+                tracker.fail('Browser not initialized');
                 throw new Error('Browser not initialized. Call browser_init first.');
             }
             const { text, selector, xpath, attributes, description, exact = false, context, shadowDOM = false, searchFrames = false } = args || {};
             // Ensure elementType has a fallback value
             const elementType = args?.elementType || '*';
+            tracker.setProgress(10, '🔧 Preparing search strategies...');
             // Helper: Search in Shadow DOM
             const searchInShadowDOM = async (sel) => {
                 return await pageInstance.evaluate((selector) => {