@dynamicu/chromedebug-mcp 2.4.3 → 2.4.5

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.4.3",
+  "version": "2.4.5",
   "description": "ChromeDebug MCP - MCP server that provides full control over a Chrome browser instance for debugging and automation with AI assistants like Claude Code",
   "main": "src/index.js",
   "type": "module",
   "bin": {
     "chromedebug-mcp": "./src/cli.js",
-    "chromedebug-mcp-server": "./src/cli-http.js"
+    "chromedebug-mcp-server": "./src/standalone-server.js"
   },
   "publishConfig": {
     "access": "public"

package/src/index.js

@@ -184,6 +184,14 @@ class ChromePilotApp {
       }
     }
 
+    // Auto-enable single-server mode on Windows
+    // This prevents HTTP server initialization issues that cause MCP crashes
+    if (process.platform === 'win32' && !args.singleServer) {
+      args.singleServer = true;
+      logger.info('Windows detected: Running in MCP-only mode (HTTP server disabled)');
+      logger.info('To start HTTP server for Chrome extension, run: chromedebug-mcp-server');
+    }
+
     return args;
   }
 

package/src/cli-http.js

@@ -1,310 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * ChromeDebug HTTP Server CLI
- * Standalone HTTP server for Chrome extension integration
- * Does not start MCP stdio server - only HTTP API server
- */
-
-import { ChromeController } from './chrome-controller.js';
-import { ChromeService } from './services/chrome-service.js';
-import { ProcessManager } from './services/process-manager.js';
-import {
-  initializeSessionManager,
-  getSessionInfo,
-  registerProcess
-} from './services/unified-session-manager.js';
-import logger from './utils/logger.js';
-
-/**
- * Standalone HTTP Server Application
- * Provides Chrome extension API without MCP stdio interface
- */
-class ChromeDebugHttpServer {
-  constructor() {
-    this.chromeController = null;
-    this.chromeService = null;
-    this.processManager = null;
-    this.sessionManager = null;
-    this.initialized = false;
-  }
-
-  /**
-   * Initializes HTTP server components
-   * @param {Object} options - Initialization options
-   */
-  async initialize(options = {}) {
-    try {
-      // Parse command line arguments
-      const args = this.parseArguments();
-      const finalOptions = { ...options, ...args };
-
-      logger.info('🚀 Starting ChromeDebug HTTP Server (Extension API)...');
-
-      // Create Chrome controller instance
-      this.chromeController = new ChromeController();
-
-      // Create Chrome service wrapper with process management
-      this.chromeService = new ChromeService(this.chromeController);
-      this.processManager = this.chromeService.getProcessManager();
-
-      // Initialize Chrome service with HTTP server REQUIRED
-      const serviceResult = await this.chromeService.initialize({
-        ...finalOptions,
-        startHttp: true, // Force HTTP server on
-        singleServer: false, // Ensure HTTP starts
-        sessionManager: this.sessionManager
-      });
-
-      if (serviceResult.httpServer) {
-        logger.info(`✅ HTTP Server Started Successfully`);
-        logger.info(`   Port: ${serviceResult.httpServer.port}`);
-        logger.info(`   Status: ${serviceResult.httpServer.status}`);
-        logger.info('');
-        logger.info('📍 Chrome Extension Connection:');
-        logger.info(`   Use port ${serviceResult.httpServer.port} in extension settings`);
-        logger.info('');
-        logger.info('💡 Server is ready for Chrome extension connections');
-      } else {
-        logger.error('❌ HTTP Server Failed to Start');
-        if (serviceResult.httpServer?.error) {
-          logger.error(`   Error: ${serviceResult.httpServer.error}`);
-        }
-        throw new Error('HTTP server initialization failed');
-      }
-
-      this.initialized = true;
-      return {
-        status: 'initialized',
-        options: finalOptions,
-        serviceResult
-      };
-    } catch (error) {
-      logger.error('Failed to initialize ChromeDebug HTTP Server:', error);
-      throw error;
-    }
-  }
-
-  /**
-   * Starts the HTTP server and keeps it running
-   */
-  async start() {
-    if (!this.initialized) {
-      await this.initialize();
-    }
-
-    try {
-      // Clean up any existing ChromeDebug processes (optional, controlled by flag)
-      const args = this.parseArguments();
-      if (!args.noCleanup) {
-        const cleanupResult = await this.processManager.cleanupChromePilotProcesses();
-        if (cleanupResult.total > 0) {
-          logger.debug(`Cleaned up ${cleanupResult.killed.length} existing processes`);
-        }
-      }
-
-      // Keep the server alive
-      logger.info('🔄 HTTP Server is running. Press Ctrl+C to stop.');
-
-      // Prevent process from exiting
-      process.stdin.resume();
-
-    } catch (error) {
-      logger.error('Failed to start ChromeDebug HTTP Server:', error);
-      process.exit(1);
-    }
-  }
-
-  /**
-   * Parses command line arguments
-   * @returns {Object} Parsed arguments
-   */
-  parseArguments() {
-    const args = {
-      debug: false,
-      sessionId: null,
-      noCleanup: false,
-      verbose: false,
-      port: null
-    };
-
-    const argv = process.argv.slice(2);
-    for (let i = 0; i < argv.length; i++) {
-      const arg = argv[i];
-
-      switch (arg) {
-        case '--debug':
-          args.debug = true;
-          break;
-        case '--session-id':
-          if (i + 1 < argv.length) {
-            args.sessionId = argv[++i];
-          } else {
-            logger.error('--session-id requires a value');
-            process.exit(1);
-          }
-          break;
-        case '--no-cleanup':
-          args.noCleanup = true;
-          break;
-        case '--verbose':
-          args.verbose = true;
-          break;
-        case '--port':
-          if (i + 1 < argv.length) {
-            args.port = parseInt(argv[++i], 10);
-          } else {
-            logger.error('--port requires a value');
-            process.exit(1);
-          }
-          break;
-        case '--help':
-          this.showHelp();
-          process.exit(0);
-          break;
-        default:
-          if (arg.startsWith('--session-id=')) {
-            args.sessionId = arg.split('=')[1];
-          } else if (arg.startsWith('--port=')) {
-            args.port = parseInt(arg.split('=')[1], 10);
-          } else if (arg.startsWith('--')) {
-            logger.error(`Unknown argument: ${arg}`);
-            this.showHelp();
-            process.exit(1);
-          }
-          break;
-      }
-    }
-
-    return args;
-  }
-
-  /**
-   * Shows help information
-   */
-  showHelp() {
-    console.log(`
-ChromeDebug HTTP Server - Standalone Chrome Extension API
-
-This server provides HTTP endpoints for Chrome extension integration.
-It does NOT start the MCP stdio server for Claude Code.
-
-Usage: chromedebug-mcp-server [options]
-
-Options:
-  --debug             Enable debug logging
-  --session-id ID     Set custom session ID for resource isolation
-  --no-cleanup        Skip cleanup of dead processes on startup
-  --verbose           Enable verbose logging including session info
-  --port PORT         Specify HTTP server port (optional, auto-discovers if not set)
-  --help              Show this help message
-
-Examples:
-  chromedebug-mcp-server
-  chromedebug-mcp-server --verbose --no-cleanup
-  chromedebug-mcp-server --port 3000
-  chromedebug-mcp-server --session-id extension-session-1
-
-Environment Variables:
-  NODE_ENV            Set to 'development' for debug mode
-  CHROME_PILOT_PORT   Configure HTTP server port
-
-What this server does:
-  ✓ Starts HTTP REST API for Chrome extension
-  ✓ Provides endpoints for screen recording uploads
-  ✓ Handles workflow recording and playback
-  ✓ Manages Chrome browser instances for extension
-
-What this server does NOT do:
-  ✗ Start MCP stdio server for Claude Code
-  ✗ Provide AI assistant integration
-
-For MCP integration, use: chromedebug-mcp
-
-For more information, see the documentation in README.md
-    `);
-  }
-
-  /**
-   * Graceful shutdown
-   */
-  async shutdown() {
-    logger.info('Shutting down ChromeDebug HTTP Server...');
-
-    try {
-      if (this.chromeService) {
-        await this.chromeService.cleanup();
-      }
-
-      if (this.processManager) {
-        await this.processManager.killAllManagedProcesses();
-      }
-
-      logger.info('HTTP Server shutdown complete');
-    } catch (error) {
-      logger.error('Error during shutdown:', error);
-    }
-  }
-}
-
-/**
- * Main entry point
- */
-async function main() {
-  const app = new ChromeDebugHttpServer();
-
-  // Parse arguments first to get session settings
-  const args = app.parseArguments();
-
-  try {
-    // Initialize unified session manager with options
-    const sessionManager = await initializeSessionManager({
-      sessionId: args.sessionId || 'http-server',
-      skipCleanup: args.noCleanup,
-      verbose: args.verbose
-    });
-
-    // Register this process for tracking
-    await registerProcess(process.pid, 'http-server');
-
-    // Log session information if verbose
-    if (args.verbose) {
-      const sessionInfo = getSessionInfo();
-      logger.debug('Session Information:');
-      logger.debug(`  Session ID: ${sessionInfo.sessionId}`);
-      logger.debug(`  PID: ${sessionInfo.pid}`);
-      logger.debug(`  Port: ${sessionInfo.port}`);
-      logger.debug(`  Session File: ${sessionInfo.sessionFile}`);
-    }
-
-    // Pass session manager to app
-    app.sessionManager = sessionManager;
-
-    await app.start();
-  } catch (error) {
-    logger.error('Fatal error starting ChromeDebug HTTP Server:', error);
-    process.exit(1);
-  }
-}
-
-// Handle graceful shutdown
-process.on('SIGINT', async () => {
-  logger.info('Received SIGINT, shutting down gracefully...');
-  process.exit(0);
-});
-
-process.on('SIGTERM', async () => {
-  logger.info('Received SIGTERM, shutting down gracefully...');
-  process.exit(0);
-});
-
-// Export for testing
-export { ChromeDebugHttpServer };
-
-// Run if this is the main module
-if (import.meta.url === `file://${process.argv[1]}`) {
-  main().catch((error) => {
-    logger.error('Unhandled error:', error);
-    process.exit(1);
-  });
-}