brave-real-browser-mcp-server 2.34.1 → 2.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.34.1",
+  "version": "2.36.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,12 +22,17 @@
     "node": ">=18.0.0"
   },
   "bin": {
-    "brave-mcp": "./dist/index.js"
+    "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",
+    "start": "node src/index.js",
+    "dev": "node src/index.js mcp",
+    "mcp": "node src/index.js mcp",
+    "mcp:verbose": "node src/index.js mcp --verbose",
+    "lsp": "node src/index.js lsp",
+    "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",
@@ -65,11 +70,13 @@
   "license": "ISC",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
-    "brave-real-puppeteer-core": "^24.49.1",
+    "brave-real-puppeteer-core": "^24.51.0",
     "ghost-cursor": "^1.4.2",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",
     "tree-kill": "^1.2.2",
+    "vscode-languageserver": "^9.0.1",
+    "vscode-languageserver-textdocument": "^1.0.12",
     "xvfb": "^0.4.0"
   },
   "devDependencies": {

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

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-blocker",
-  "version": "1.10.1",
+  "version": "1.12.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.49.1",
+    "brave-real-puppeteer-core": "^24.51.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.16.1",
+  "version": "1.18.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.10.1",
+    "brave-real-blocker": "^1.12.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.49.1",
+  "version": "24.51.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.16.1",
+    "brave-real-launcher": "^1.18.0",
     "get-east-asian-width": "^1.4.0",
     "yargs": "^18.0.0"
   },

package/src/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * Brave Real Browser - Unified Entry Point
+ * 
+ * Usage:
+ *   node src/index.js mcp        - Start MCP Server (default)
+ *   node src/index.js lsp        - Start LSP Server
+ *   node src/index.js --help     - Show help
+ * 
+ * npm scripts:
+ *   npm run dev                  - Start MCP server
+ *   npm run mcp                  - Start MCP server
+ *   npm run lsp                  - Start LSP server
+ * 
+ * For AI Assistants (MCP):
+ *   Claude Desktop, Cursor, Copilot, etc.
+ * 
+ * For IDEs (LSP):
+ *   VS Code, Neovim, Sublime Text, etc.
+ */
+
+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}mcp${colors.reset}           Start MCP Server for AI agents (default)
+  ${colors.green}lsp${colors.reset}           Start LSP Server for IDE intelligence
+
+${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 mcp          # Start MCP server
+  node src/index.js lsp          # Start LSP server
+  node src/index.js --list       # List all tools
+
+${colors.bright}NPM SCRIPTS:${colors.reset}
+  npm run dev                    # Start MCP server
+  npm run mcp                    # Start MCP server
+  npm run lsp                    # Start LSP server
+
+${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')}
+
+${colors.dim}MCP: For AI assistants (Claude, Cursor, Copilot)
+LSP: For IDE code intelligence (VS Code, Neovim)${colors.reset}
+  `);
+}
+
+/**
+ * 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) {
+      const required = tool.inputSchema?.required || [];
+      console.log(`  ${tool.emoji} ${colors.yellow}${tool.name.padEnd(25)}${colors.reset} ${colors.dim}${tool.description.substring(0, 40)}${colors.reset}`);
+    }
+    console.log('');
+  }
+}
+
+/**
+ * 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())) || 'mcp';
+  
+  if (hasHelp) {
+    showHelp();
+    process.exit(0);
+  }
+  
+  if (hasList) {
+    listTools();
+    process.exit(0);
+  }
+  
+  // Start appropriate server
+  if (mode.toLowerCase() === 'lsp') {
+    // Start LSP Server
+    require('./lsp/index.js');
+  } else {
+    // Start MCP Server (default)
+    require('./mcp/index.js');
+  }
+}
+
+// Export for programmatic use
+module.exports = {
+  TOOLS,
+  TOOL_DISPLAY,
+  CATEGORIES,
+  startMCP: () => require('./mcp/index.js'),
+  startLSP: () => require('./lsp/index.js'),
+};
+
+// Run if called directly
+if (require.main === module) {
+  main().catch(error => {
+    console.error(`${colors.red}❌ Fatal error:${colors.reset}`, error.message);
+    process.exit(1);
+  });
+}

package/src/lsp/capabilities/autocomplete.js

@@ -0,0 +1,102 @@
+/**
+ * Autocomplete Capability
+ */
+const { CompletionItemKind, InsertTextFormat } = require('vscode-languageserver/node');
+
+function getCompletions(document, position, tools, lang, settings) {
+  const text = document.getText();
+  const offset = document.offsetAt(position);
+  const lineText = text.split('\n')[position.line] || '';
+  const prefix = getPrefix(lineText, position.character);
+  const completions = [];
+  const context = detectContext(text, offset);
+
+  if (context.type === 'tool_name' || context.type === 'start') {
+    for (const tool of tools) {
+      const toolLang = lang.tools[tool.name] || {};
+      if (tool.name.toLowerCase().startsWith(prefix) || prefix === '') {
+        completions.push({
+          label: tool.name,
+          kind: CompletionItemKind.Function,
+          detail: `${tool.emoji} ${toolLang.detail || tool.description}`,
+          documentation: toolLang.documentation || tool.description,
+          insertText: generateToolSnippet(tool),
+          insertTextFormat: InsertTextFormat.Snippet,
+          data: { toolName: tool.name },
+          sortText: `0_${tool.name}`,
+        });
+      }
+    }
+  }
+
+  if (context.type === 'parameter_name') {
+    const tool = tools.find(t => t.name === context.toolName);
+    if (tool?.inputSchema?.properties) {
+      const toolLang = lang.tools[tool.name] || {};
+      for (const [name, schema] of Object.entries(tool.inputSchema.properties)) {
+        if (name.toLowerCase().startsWith(prefix) || prefix === '') {
+          completions.push({
+            label: name,
+            kind: CompletionItemKind.Property,
+            detail: schema.type,
+            documentation: toolLang.parameters?.[name] || schema.description,
+            insertText: `${name}: `,
+            sortText: tool.inputSchema.required?.includes(name) ? `0_${name}` : `1_${name}`,
+          });
+        }
+      }
+    }
+  }
+
+  if (context.type === 'parameter_value') {
+    const tool = tools.find(t => t.name === context.toolName);
+    const schema = tool?.inputSchema?.properties?.[context.paramName];
+    if (schema?.enum) {
+      for (const value of schema.enum) {
+        completions.push({ label: value, kind: CompletionItemKind.EnumMember, insertText: `'${value}'` });
+      }
+    }
+    if (schema?.type === 'boolean') {
+      completions.push({ label: 'true', kind: CompletionItemKind.Keyword }, { label: 'false', kind: CompletionItemKind.Keyword });
+    }
+  }
+
+  return completions;
+}
+
+function generateToolSnippet(tool) {
+  const required = tool.inputSchema.required || [];
+  const props = tool.inputSchema.properties || {};
+  if (required.length === 0) return `${tool.name}()`;
+  let i = 1;
+  const params = required.map(p => {
+    const prop = props[p];
+    if (prop?.type === 'string') return `${p}: '\${${i++}}'`;
+    if (prop?.type === 'boolean') return `${p}: \${${i++}:false}`;
+    if (prop?.type === 'number') return `${p}: \${${i++}:0}`;
+    return `${p}: \${${i++}}`;
+  });
+  return `${tool.name}({ ${params.join(', ')} })`;
+}
+
+function getPrefix(line, char) {
+  let start = char;
+  while (start > 0 && /\w/.test(line[start - 1])) start--;
+  return line.substring(start, char).toLowerCase();
+}
+
+function detectContext(text, offset) {
+  const before = text.substring(0, offset);
+  if (/(\w+)\s*\(\s*\{[^}]*(\w+)\s*:\s*['"]?$/.test(before)) {
+    const match = before.match(/(\w+)\s*\(\s*\{[^}]*(\w+)\s*:\s*['"]?$/);
+    return { type: 'parameter_value', toolName: match[1], paramName: match[2] };
+  }
+  if (/(\w+)\s*\(\s*\{[^}]*$/.test(before)) {
+    const match = before.match(/(\w+)\s*\(\s*\{[^}]*$/);
+    return { type: 'parameter_name', toolName: match[1] };
+  }
+  if (/(?:await\s+|^\s*)$/.test(before)) return { type: 'tool_name' };
+  return { type: 'start' };
+}
+
+module.exports = { getCompletions };