@dynamicu/chromedebug-mcp 2.5.2 → 2.5.4

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "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/index.js",
+    "chromedebug-mcp": "./src/cli.js",
     "chromedebug-mcp-server": "./src/standalone-server.js"
   },
   "publishConfig": {

package/src/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+/**
+ * Chrome Debug MCP Server - CLI Entry Point
+ *
+ * This file should only be executed directly as a CLI command.
+ * For library usage, import ChromePilotApp from './index.js'
+ *
+ * This separation ensures that importing the package as a library
+ * won't accidentally launch Chrome or start servers.
+ */
+
+import { ChromePilotApp } from './index.js';
+import {
+  initializeSessionManager,
+  getSessionInfo,
+  registerProcess,
+  findActiveSessions
+} from './services/unified-session-manager.js';
+import logger from './utils/logger.js';
+
+/**
+ * Main CLI entry point
+ */
+async function main() {
+  const app = new ChromePilotApp();
+
+  // Parse arguments first to get session settings
+  const args = app.parseArguments();
+
+  // Detect Windows and provide WSL2 guidance
+  if (process.platform === 'win32' && !process.env.WSL_DISTRO_NAME && !process.env.CHROMEDEBUG_FORCE_WINDOWS) {
+    console.error(`
+⚠️  ChromeDebug MCP runs best on Unix-based systems.
+
+Windows users have two options:
+
+1. WSL2 (RECOMMENDED - Full Compatibility):
+   • Install WSL2: Run in PowerShell as Admin:
+     wsl --install
+   • Restart your computer
+   • Inside WSL, install Node.js:
+     sudo apt update && sudo apt install nodejs npm
+   • Install ChromeDebug in WSL:
+     npm install -g @dynamicu/chromedebug-mcp
+   • Configure Claude to use WSL:
+     claude mcp add chromedebug -s user -- wsl chromedebug-mcp
+
+2. Native Windows (LIMITED - May have stdio issues):
+   • Set: set CHROMEDEBUG_FORCE_WINDOWS=1
+   • Then run: chromedebug-mcp
+   • Note: MCP stdio communication may fail due to cmd.exe limitations
+
+For details: https://github.com/dynamicupgrade/ChromeDebug#windows-setup
+`);
+    process.exit(1);
+  }
+
+  try {
+    // Initialize unified session manager with options
+    const sessionManager = await initializeSessionManager({
+      sessionId: args.sessionId,
+      skipCleanup: args.noCleanup,
+      verbose: args.verbose
+    });
+
+    // Register this process for tracking
+    await registerProcess(process.pid, 'mcp-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}`);
+
+      // Show other active sessions
+      const activeSessions = await findActiveSessions();
+      if (activeSessions.length > 1) {
+        logger.debug(`  Other active sessions: ${activeSessions.length - 1}`);
+        activeSessions.filter(s => s.sessionId !== sessionInfo.sessionId).forEach(session => {
+          logger.debug(`    - ${session.sessionId} (PID: ${session.pid}, Port: ${session.port})`);
+        });
+      }
+    }
+
+    // Pass session manager to app
+    app.sessionManager = sessionManager;
+
+    await app.start();
+  } catch (error) {
+    logger.error('Fatal error starting Chrome Debug:', 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);
+});
+
+// Always run main in CLI context
+main().catch((error) => {
+  logger.error('Unhandled error:', error);
+  process.exit(1);
+});

package/src/index.js

@@ -254,101 +254,6 @@ For more information, see the documentation in CLAUDE.md
   }
 }
 
-/**
- * Main entry point
- */
-async function main() {
-  const app = new ChromePilotApp();
-
-  // Parse arguments first to get session settings
-  const args = app.parseArguments();
-
-  // Detect Windows and provide WSL2 guidance
-  if (process.platform === 'win32' && !process.env.WSL_DISTRO_NAME && !process.env.CHROMEDEBUG_FORCE_WINDOWS) {
-    console.error(`
-⚠️  ChromeDebug MCP runs best on Unix-based systems.
-
-Windows users have two options:
-
-1. WSL2 (RECOMMENDED - Full Compatibility):
-   • Install WSL2: Run in PowerShell as Admin:
-     wsl --install
-   • Restart your computer
-   • Inside WSL, install Node.js:
-     sudo apt update && sudo apt install nodejs npm
-   • Install ChromeDebug in WSL:
-     npm install -g @dynamicu/chromedebug-mcp
-   • Configure Claude to use WSL:
-     claude mcp add chromedebug -s user -- wsl chromedebug-mcp
-
-2. Native Windows (LIMITED - May have stdio issues):
-   • Set: set CHROMEDEBUG_FORCE_WINDOWS=1
-   • Then run: chromedebug-mcp
-   • Note: MCP stdio communication may fail due to cmd.exe limitations
-
-For details: https://github.com/dynamicupgrade/ChromeDebug#windows-setup
-`);
-    process.exit(1);
-  }
-
-  try {
-    // Initialize unified session manager with options
-    const sessionManager = await initializeSessionManager({
-      sessionId: args.sessionId,
-      skipCleanup: args.noCleanup,
-      verbose: args.verbose
-    });
-
-    // Register this process for tracking
-    await registerProcess(process.pid, 'mcp-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}`);
-
-      // Show other active sessions
-      const activeSessions = await findActiveSessions();
-      if (activeSessions.length > 1) {
-        logger.debug(`  Other active sessions: ${activeSessions.length - 1}`);
-        activeSessions.filter(s => s.sessionId !== sessionInfo.sessionId).forEach(session => {
-          logger.debug(`    - ${session.sessionId} (PID: ${session.pid}, Port: ${session.port})`);
-        });
-      }
-    }
-
-    // Pass session manager to app
-    app.sessionManager = sessionManager;
-
-    await app.start();
-  } catch (error) {
-    logger.error('Fatal error starting Chrome Debug:', 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 { ChromePilotApp };
-
-// 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);
-  });
-}
+// Export for library usage and testing
+// This file is now safe to import without side effects
+export { ChromePilotApp };