real-browser-mcp-server 1.3.4 → 1.4.0

package/src/mcp/index.js

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-// CRITICAL: Redirect ALL console.log to STDERR BEFORE any imports.
-// MCP uses STDIO transport — STDOUT must contain ONLY JSON-RPC messages.
-// Any console.log from ANY dependency will corrupt the JSON-RPC stream.
-console.log = function (...args) { console.error(...args); };
-
-/**
- * Brave Real Browser MCP Server - Entry Point
- * 
- * Usage:
- *   npm run dev     - Start MCP server
- *   npm run mcp     - Start MCP server (alias)
- * 
- * For AI Assistants:
- *   Claude Desktop, Cursor, Copilot, etc.
- */
-
-const { TOOL_DISPLAY } = require('./tools.js');
-const { startServer, shutdownServer } = require('./server.js');
-const { cleanup } = require('./handlers.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 startup banner and tools
- */
-function displayStartupBanner() {
-  console.error('');
-  console.error(`${colors.bright}${colors.cyan}╔════════════════════════════════════════════════════════════╗${colors.reset}`);
-  console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.bright}${colors.magenta}🦁 Real Browser MCP Server${colors.reset}                                 ${colors.cyan}║${colors.reset}`);
-  console.error(`${colors.bright}${colors.cyan}║${colors.reset}  ${colors.dim}Playwright + Patchright + Stealth + Turnstile${colors.reset}            ${colors.cyan}║${colors.reset}`);
-  console.error(`${colors.bright}${colors.cyan}╚════════════════════════════════════════════════════════════╝${colors.reset}`);
-  console.error('');
-
-  console.error(`${colors.bright}${colors.green}📦 Available Tools (${TOOL_DISPLAY.length}):${colors.reset}`);
-  console.error(`${colors.dim}${'─'.repeat(60)}${colors.reset}`);
-
-  // Display tools in 2 columns
-  const half = Math.ceil(TOOL_DISPLAY.length / 2);
-
-  for (let i = 0; i < half; i++) {
-    const left = TOOL_DISPLAY[i];
-    const right = TOOL_DISPLAY[i + half];
-
-    const leftStr = left
-      ? `${left.emoji} ${colors.yellow}${left.name.padEnd(22)}${colors.reset}`
-      : '';
-    const rightStr = right
-      ? `${right.emoji} ${colors.yellow}${right.name}${colors.reset}`
-      : '';
-
-    console.error(`  ${leftStr}${rightStr}`);
-  }
-
-  console.error(`${colors.dim}${'─'.repeat(60)}${colors.reset}`);
-  console.error('');
-  // Fetch SDK version dynamically
-  let sdkVersion = 'Latest';
-  try {
-    const pkgPath = require('path').join(__dirname, '..', '..', 'package.json');
-    const pkg = require('fs').readFileSync(pkgPath, 'utf8');
-    const deps = JSON.parse(pkg).dependencies || {};
-    if (deps['@modelcontextprotocol/sdk']) {
-      sdkVersion = deps['@modelcontextprotocol/sdk'].replace(/[\^~]/g, '');
-    }
-  } catch (e) { /* ignore */ }
-
-  console.error(`${colors.bright}${colors.blue}🔗 Transport:${colors.reset} STDIO (for MCP clients)`);
-  console.error(`${colors.bright}${colors.blue}📡 Protocol:${colors.reset} Model Context Protocol (SDK v${sdkVersion})`);
-  console.error('');
-  console.error(`${colors.dim}Press CTRL+C to stop the server${colors.reset}`);
-  console.error('');
-}
-
-/**
- * Display tool details (verbose mode)
- */
-function displayToolDetails() {
-  console.error(`${colors.bright}${colors.green}📋 Tool Details:${colors.reset}`);
-  console.error('');
-
-  for (const tool of TOOL_DISPLAY) {
-    console.error(`  ${tool.emoji} ${colors.bright}${colors.yellow}${tool.name}${colors.reset}`);
-    console.error(`     ${colors.dim}${tool.description}${colors.reset}`);
-    if (tool.descriptionHindi) {
-      console.error(`     ${colors.dim}(${tool.descriptionHindi})${colors.reset}`);
-    }
-    console.error('');
-  }
-}
-
-/**
- * Setup graceful shutdown handlers
- */
-function setupShutdownHandlers(server) {
-  let isShuttingDown = false;
-
-  const gracefulShutdown = async (signal) => {
-    if (isShuttingDown) return;
-    isShuttingDown = true;
-
-    console.error('');
-    console.error(`${colors.bright}${colors.yellow}🧹 Cleanup in progress...${colors.reset}`);
-
-    try {
-      await cleanup();
-      console.error(`${colors.bright}${colors.green}✅ Browser closed${colors.reset}`);
-    } catch (e) {
-      console.error(`${colors.dim}Browser already closed${colors.reset}`);
-    }
-
-    try {
-      await shutdownServer(server);
-      console.error(`${colors.bright}${colors.green}✅ MCP Server stopped${colors.reset}`);
-    } catch (e) {
-      // Server may already be closed
-    }
-
-    console.error(`${colors.bright}${colors.magenta}👋 Goodbye!${colors.reset}`);
-    console.error('');
-
-    process.exit(0);
-  };
-
-  // Handle various termination signals
-  process.on('SIGINT', () => gracefulShutdown('SIGINT'));
-  process.on('SIGTERM', () => gracefulShutdown('SIGTERM'));
-  process.on('SIGHUP', () => gracefulShutdown('SIGHUP'));
-
-  // Handle uncaught errors
-  process.on('uncaughtException', async (error) => {
-    console.error(`${colors.bright}${colors.red}❌ Uncaught Exception:${colors.reset}`, error.message);
-    await gracefulShutdown('error');
-  });
-
-  process.on('unhandledRejection', async (reason) => {
-    console.error(`${colors.bright}${colors.red}❌ Unhandled Rejection:${colors.reset}`, reason);
-    await gracefulShutdown('error');
-  });
-}
-
-/**
- * Main entry point
- */
-async function main() {
-  // Check for verbose flag
-  const verbose = process.argv.includes('--verbose') || process.argv.includes('-v');
-
-  // Display startup info
-  displayStartupBanner();
-
-  if (verbose) {
-    displayToolDetails();
-  }
-
-  try {
-    // Start MCP server
-    console.error(`${colors.bright}${colors.green}🚀 Starting MCP Server...${colors.reset}`);
-
-    const { server } = await startServer();
-
-    console.error(`${colors.bright}${colors.green}✅ MCP Server running${colors.reset}`);
-    console.error(`${colors.dim}Waiting for client connections via STDIO...${colors.reset}`);
-    console.error('');
-
-    // Setup shutdown handlers
-    setupShutdownHandlers(server);
-
-  } catch (error) {
-    console.error(`${colors.bright}${colors.red}❌ Failed to start server:${colors.reset}`, error.message);
-    process.exit(1);
-  }
-}
-
-// Run main
-main().catch(error => {
-  console.error(`${colors.bright}${colors.red}❌ Fatal error:${colors.reset}`, error.message);
-  process.exit(1);
-});

package/src/mcp/server.js

@@ -1,144 +0,0 @@
-/**
- * Brave Real Browser MCP Server
- * 
- * Model Context Protocol Server with STDIO Transport
- * Supports: Claude, Cursor, Copilot, and other MCP-compatible AI assistants
- */
-
-// CRITICAL: Redirect ALL console.log to STDERR before ANY imports
-// MCP uses STDIO transport — STDOUT must contain ONLY JSON-RPC messages.
-// Any console.log from this code or ANY dependency (browser, blocker, etc.)
-// will corrupt the JSON-RPC stream and cause parsing errors.
-const _originalConsoleLog = console.log;
-console.log = function (...args) {
-  console.error(...args);
-};
-
-const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
-const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
-const {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  ErrorCode,
-  McpError,
-} = require('@modelcontextprotocol/sdk/types.js');
-
-const { TOOLS } = require('./tools.js');
-const { executeTool, cleanup } = require('./handlers.js');
-
-/**
- * Create and configure MCP Server
- */
-function createServer() {
-  const server = new Server(
-    {
-      name: 'real-browser-mcp-server',
-      version: '2.48.36',
-    },
-    {
-      capabilities: {
-        tools: {},
-      },
-    }
-  );
-
-  // Handle list tools request
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-      tools: TOOLS.map(tool => ({
-        name: tool.name,
-        description: `${tool.emoji} ${tool.description}`,
-        inputSchema: tool.inputSchema,
-      })),
-    };
-  });
-
-  // Handle call tool request
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-
-    // Find tool definition
-    const tool = TOOLS.find(t => t.name === name);
-    if (!tool) {
-      throw new McpError(
-        ErrorCode.MethodNotFound,
-        `Unknown tool: ${name}`
-      );
-    }
-
-    try {
-      // Execute the tool
-      const result = await executeTool(name, args || {});
-
-      // Format response
-      if (result.success === false && result.error) {
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify({ error: result.error }, null, 2),
-            },
-          ],
-          isError: true,
-        };
-      }
-
-      if (result.mcpContent) {
-        return { content: result.mcpContent };
-      }
-
-      return {
-        content: [
-          {
-            type: 'text',
-            text: JSON.stringify(result, null, 2),
-          },
-        ],
-      };
-    } catch (error) {
-      return {
-        content: [
-          {
-            type: 'text',
-            text: JSON.stringify({ error: error.message }, null, 2),
-          },
-        ],
-        isError: true,
-      };
-    }
-  });
-
-  return server;
-}
-
-/**
- * Start MCP Server with STDIO transport
- */
-async function startServer() {
-  const server = createServer();
-  const transport = new StdioServerTransport();
-
-  // Connect server to transport
-  await server.connect(transport);
-
-  return { server, transport };
-}
-
-/**
- * Graceful shutdown
- */
-async function shutdownServer(server) {
-  // Cleanup browser resources
-  await cleanup();
-
-  // Close server
-  if (server) {
-    await server.close();
-  }
-}
-
-module.exports = {
-  createServer,
-  startServer,
-  shutdownServer,
-};