brave-real-browser-mcp-server 2.35.0 → 2.37.0

package/README.md

@@ -14,7 +14,8 @@ A production-ready MCP (Model Context Protocol) server that combines Puppeteer w
 
 | Feature | Description |
 |---------|-------------|
-| MCP Server | Model Context Protocol compatible server |
+| **MCP Server** | Model Context Protocol compatible server with 28 tools |
+| **LSP Server** | Language Server Protocol for IDE code intelligence |
 | Brave Browser | Uses Brave instead of Chromium for better privacy |
 | 50+ Stealth Features | Passes all major bot detectors |
 | Built-in Ad Blocker | uBlock Origin filters with auto-update |
@@ -25,6 +26,7 @@ A production-ready MCP (Model Context Protocol) server that combines Puppeteer w
 | Auto-Install | Brave auto-installs if missing |
 | TypeScript Support | Full type definitions included |
 | ESM + CJS | Dual module support |
+| **Multi-language** | English & Hindi language support |
 | **Auto-Update** | Daily automatic dependency updates |
 | **Auto-Publish** | Automatic NPM publishing on updates |
 | **Monorepo** | npm workspaces with linked packages |
@@ -127,6 +129,113 @@ AI: [Calls file_downloader with url="..."] -> Downloaded to ./downloads/image.pn
 
 ---
 
+## LSP Server (Language Server Protocol)
+
+This package also includes a full-featured **LSP Server** for IDE code intelligence when writing browser automation scripts.
+
+### Quick Start LSP Server
+
+```bash
+# Start the LSP server
+npm run lsp
+```
+
+### LSP Capabilities
+
+| Feature | Description |
+|---------|-------------|
+| **Autocomplete** | Tool names, parameters, and enum values |
+| **Hover** | Full documentation on hover |
+| **Diagnostics** | Error & warning detection (missing browser_init, etc.) |
+| **Snippets** | Code templates for common workflows |
+| **Refactoring** | Quick fixes (add browser_init, try-catch, etc.) |
+| **Simulation** | Workflow simulation in IDE |
+| **Multi-language** | English & Hindi support |
+
+### VS Code Setup
+
+Create `.vscode/settings.json` in your project:
+
+```json
+{
+  "braveRealBrowser.language": "en",
+  "braveRealBrowser.maxDiagnostics": 100,
+  "braveRealBrowser.enableSnippets": true,
+  "braveRealBrowser.enableSimulation": true,
+  "braveRealBrowser.enableRefactoring": true
+}
+```
+
+### Diagnostic Features
+
+The LSP detects common issues:
+
+- Missing `browser_init()` before page operations
+- Missing `navigate()` before content extraction
+- Invalid selectors and URLs
+- Missing required parameters
+- Unclosed browser sessions
+- Security issues (eval usage, etc.)
+
+### Quick Fixes
+
+When diagnostics are detected, quick fixes are offered:
+
+- Add `browser_init()` at start
+- Add `navigate()` before page tools
+- Add `browser_close()` at end
+- Wrap in try-catch
+- Extract to function
+
+---
+
+## Unified Architecture
+
+Both MCP and LSP servers share the same tool definitions:
+
+```
+src/
+├── shared/
+│   └── tools.js         # Single source of truth (28 tools)
+├── mcp/
+│   ├── server.js        # MCP server for AI agents
+│   └── handlers.js      # Tool implementations
+├── lsp/
+│   ├── server.js        # LSP server for IDEs
+│   └── capabilities/    # Autocomplete, hover, diagnostics, etc.
+└── index.js             # Unified entry point
+```
+
+### Unified CLI
+
+```bash
+# List all tools
+node src/index.js --list
+
+# Start MCP server (default)
+node src/index.js mcp
+
+# Start LSP server
+node src/index.js lsp
+
+# Show help
+node src/index.js --help
+```
+
+### Tool Categories
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Browser** | 3 | Browser lifecycle (init, close, cookies) |
+| **Navigation** | 1 | Page navigation |
+| **Interaction** | 8 | User actions (click, type, scroll, etc.) |
+| **Extraction** | 10 | Content scraping (HTML, JSON, links, etc.) |
+| **Network** | 3 | Network operations (recorder, download, trace) |
+| **Analysis** | 1 | Page analysis (SEO, performance, etc.) |
+| **Utility** | 2 | Helpers (wait, progress tracker) |
+
+---
+
 ## Monorepo Ecosystem
 
 ```
@@ -398,9 +507,12 @@ console.log(blocker === sameBlocker); // true
 
 | Command | Description |
 |---------|-------------|
+| `npm start` | Start unified server (MCP by default) |
 | `npm run dev` | Start MCP server |
 | `npm run mcp` | Start MCP server (alias) |
 | `npm run mcp:verbose` | Start MCP server with tool details |
+| `npm run lsp` | Start LSP server for IDE intelligence |
+| `npm run list` | List all 28 tools with categories |
 | `npm install` | Install all dependencies with workspace linking |
 | `npm test` | Run all tests (CJS + ESM) |
 | `npm run cjs_test` | Run CommonJS tests only |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.35.0",
+  "version": "2.37.0",
   "description": "MCP Server for Brave Real Browser - Puppeteer with Brave Browser, Stealth Mode, Ad Blocker, and Turnstile Auto-Solver for undetectable web automation.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",
@@ -22,14 +22,18 @@
     "node": ">=18.0.0"
   },
   "bin": {
+    "brave": "./src/index.js",
     "brave-mcp": "./dist/index.js",
     "brave-lsp": "./src/lsp/index.js"
   },
   "scripts": {
-    "dev": "node src/mcp/index.js",
-    "mcp": "node src/mcp/index.js",
-    "mcp:verbose": "node src/mcp/index.js --verbose",
-    "lsp": "node src/lsp/index.js",
+    "start": "node src/index.js",
+    "dev": "node src/index.js",
+    "mcp": "node src/index.js mcp",
+    "mcp:verbose": "node src/index.js mcp --verbose",
+    "lsp": "node src/index.js lsp",
+    "lsp:tcp": "node src/lsp/server.js --tcp",
+    "list": "node src/index.js --list",
     "build": "echo 'Root package uses pre-built lib/ - no build needed'",
     "build:self": "echo 'Root package uses pre-built lib/ - no build needed'",
     "test": "npm run cjs_test && npm run esm_test",
@@ -67,7 +71,7 @@
   "license": "ISC",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
-    "brave-real-puppeteer-core": "^24.50.0",
+    "brave-real-puppeteer-core": "^24.52.0",
     "ghost-cursor": "^1.4.2",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",

package/packages/brave-real-blocker/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-blocker",
-  "version": "1.11.0",
+  "version": "1.13.0",
   "description": "Advanced uBlock Origin management and stealth features for Brave Real Browser",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -63,7 +63,7 @@
     "@types/adm-zip": "^0.5.5",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^20.0.0",
-    "brave-real-puppeteer-core": "^24.50.0",
+    "brave-real-puppeteer-core": "^24.52.0",
     "mocha": "^10.4.0",
     "puppeteer-core": "^24.35.0",
     "sinon": "^17.0.1",

package/packages/brave-real-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-launcher",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "Launch Brave Browser with ease from node. Based on chrome-launcher with Brave-specific support.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -54,7 +54,7 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "brave-real-blocker": "^1.11.0",
+    "brave-real-blocker": "^1.13.0",
     "escape-string-regexp": "^4.0.0",
     "is-wsl": "^2.2.0",
     "which": "^4.0.0"

package/packages/brave-real-puppeteer-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-puppeteer-core",
-  "version": "24.50.0",
+  "version": "24.52.0",
   "description": "🦁 Brave Real-World Optimized Puppeteer & Playwright Core with 1-5ms ultra-fast timing, 50+ professional stealth features, intelligent browser auto-detection, and 100% bot detection bypass. Features cross-platform Brave browser integration, comprehensive anti-detection, and breakthrough performance improvements.",
   "keywords": [
     "automation",
@@ -132,7 +132,7 @@
     "test-version": "node ./scripts/test-version-management.js"
   },
   "dependencies": {
-    "brave-real-launcher": "^1.17.0",
+    "brave-real-launcher": "^1.19.0",
     "get-east-asian-width": "^1.4.0",
     "yargs": "^18.0.0"
   },

package/src/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * Brave Real Browser - Unified Entry Point
+ * 
+ * Usage:
+ *   node src/index.js             - Start both MCP + LSP together (default)
+ *   node src/index.js mcp         - Start MCP Server only
+ *   node src/index.js lsp         - Start LSP Server only (STDIO)
+ *   node src/index.js --help      - Show help
+ * 
+ * npm scripts:
+ *   npm run dev                   - Start MCP + LSP together
+ *   npm run mcp                   - Start MCP server only
+ *   npm run lsp                   - Start LSP server only
+ * 
+ * Architecture:
+ *   MCP Server → STDIO transport (for AI agents: Claude, Cursor, Copilot)
+ *   LSP Server → TCP :7777 (for IDEs: VS Code, Neovim)
+ */
+
+const { TOOLS, TOOL_DISPLAY, CATEGORIES } = require('./shared/tools.js');
+
+// ANSI colors for terminal
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  red: '\x1b[31m',
+};
+
+/**
+ * Display help message
+ */
+function showHelp() {
+  console.log(`
+${colors.bright}${colors.cyan}🦁 Brave Real Browser - Unified Server${colors.reset}
+
+${colors.bright}USAGE:${colors.reset}
+  node src/index.js [mode] [options]
+
+${colors.bright}MODES:${colors.reset}
+  ${colors.green}(default)${colors.reset}     Start both MCP + LSP servers together
+  ${colors.green}mcp${colors.reset}           Start MCP Server only (for AI agents)
+  ${colors.green}lsp${colors.reset}           Start LSP Server only (for IDEs)
+
+${colors.bright}OPTIONS:${colors.reset}
+  ${colors.yellow}--help, -h${colors.reset}    Show this help message
+  ${colors.yellow}--verbose, -v${colors.reset} Show detailed tool information
+  ${colors.yellow}--list${colors.reset}        List all available tools
+
+${colors.bright}EXAMPLES:${colors.reset}
+  node src/index.js              # Start MCP + LSP together
+  node src/index.js mcp          # Start MCP server only
+  node src/index.js lsp          # Start LSP server only
+  node src/index.js --list       # List all tools
+
+${colors.bright}NPM SCRIPTS:${colors.reset}
+  npm run dev                    # Start MCP + LSP together
+  npm run mcp                    # Start MCP server only
+  npm run lsp                    # Start LSP server only (STDIO)
+
+${colors.bright}ARCHITECTURE:${colors.reset}
+  ${colors.cyan}MCP Server${colors.reset} → STDIO transport → AI Agents (Claude, Cursor, Copilot)
+  ${colors.cyan}LSP Server${colors.reset} → TCP :7777      → IDEs (VS Code, Neovim)
+
+${colors.bright}TOOL CATEGORIES (${TOOLS.length} tools):${colors.reset}
+${Object.entries(CATEGORIES).map(([key, cat]) => {
+  const count = TOOLS.filter(t => t.category === key).length;
+  return `  ${cat.emoji} ${colors.yellow}${cat.name.padEnd(15)}${colors.reset} ${colors.dim}(${count} tools)${colors.reset}`;
+}).join('\n')}
+  `);
+}
+
+/**
+ * List all available tools
+ */
+function listTools() {
+  console.log(`\n${colors.bright}${colors.cyan}🦁 Available Tools (${TOOLS.length}):${colors.reset}\n`);
+  
+  for (const [key, cat] of Object.entries(CATEGORIES)) {
+    const tools = TOOLS.filter(t => t.category === key);
+    if (tools.length === 0) continue;
+    
+    console.log(`${colors.bright}${cat.emoji} ${cat.name}${colors.reset} ${colors.dim}(${tools.length})${colors.reset}`);
+    console.log(`${colors.dim}${'─'.repeat(50)}${colors.reset}`);
+    
+    for (const tool of tools) {
+      console.log(`  ${tool.emoji} ${colors.yellow}${tool.name.padEnd(25)}${colors.reset} ${colors.dim}${tool.description.substring(0, 40)}${colors.reset}`);
+    }
+    console.log('');
+  }
+}
+
+/**
+ * Start both MCP and LSP servers together
+ */
+async function startBothServers() {
+  console.error('');
+  console.error(`${colors.bright}${colors.cyan}╔════════════════════════════════════════════════════════════╗${colors.reset}`);
+  console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.bright}${colors.magenta}🦁 Brave Real Browser - Unified Server${colors.reset}                  ${colors.cyan}║${colors.reset}`);
+  console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.dim}MCP (AI Agents) + LSP (IDE Intelligence)${colors.reset}                 ${colors.cyan}║${colors.reset}`);
+  console.error(`${colors.bright}${colors.cyan}╚════════════════════════════════════════════════════════════╝${colors.reset}`);
+  console.error('');
+
+  // Start LSP Server on TCP first (background)
+  console.error(`${colors.bright}${colors.blue}📡 Starting LSP Server...${colors.reset}`);
+  
+  try {
+    const { startTcpServer, LSP_PORT } = require('./lsp/server.js');
+    const { port } = await startTcpServer();
+    console.error(`${colors.bright}${colors.green}✅ LSP Server running on TCP :${port}${colors.reset}`);
+    console.error(`${colors.dim}   IDEs can connect to: 127.0.0.1:${port}${colors.reset}`);
+  } catch (err) {
+    console.error(`${colors.yellow}⚠️  LSP Server failed: ${err.message}${colors.reset}`);
+    console.error(`${colors.dim}   Continuing with MCP only...${colors.reset}`);
+  }
+
+  console.error('');
+  
+  // Start MCP Server on STDIO (foreground)
+  console.error(`${colors.bright}${colors.blue}🚀 Starting MCP Server...${colors.reset}`);
+  
+  // Import and run MCP server
+  require('./mcp/index.js');
+}
+
+/**
+ * Main entry point
+ */
+async function main() {
+  const args = process.argv.slice(2);
+  
+  // Parse arguments
+  const hasHelp = args.includes('--help') || args.includes('-h');
+  const hasList = args.includes('--list');
+  const mode = args.find(a => ['mcp', 'lsp'].includes(a.toLowerCase()));
+  
+  if (hasHelp) {
+    showHelp();
+    process.exit(0);
+  }
+  
+  if (hasList) {
+    listTools();
+    process.exit(0);
+  }
+  
+  // Start appropriate server(s)
+  if (mode?.toLowerCase() === 'lsp') {
+    // Start LSP Server only (STDIO mode)
+    require('./lsp/index.js');
+  } else if (mode?.toLowerCase() === 'mcp') {
+    // Start MCP Server only
+    require('./mcp/index.js');
+  } else {
+    // Default: Start both servers together
+    await startBothServers();
+  }
+}
+
+// Export for programmatic use
+module.exports = {
+  TOOLS,
+  TOOL_DISPLAY,
+  CATEGORIES,
+  startMCP: () => require('./mcp/index.js'),
+  startLSP: () => require('./lsp/index.js'),
+  startBoth: startBothServers,
+};
+
+// Run if called directly
+if (require.main === module) {
+  main().catch(error => {
+    console.error(`${colors.red}❌ Fatal error:${colors.reset}`, error.message);
+    process.exit(1);
+  });
+}