@dynamicu/chromedebug-mcp 2.4.1 → 2.4.2

package/README.md

@@ -30,12 +30,22 @@ npm install
 
 ### As MCP Server
 
-To add Chrome Debug to your Claude desktop app:
+#### macOS / Linux
 
 ```bash
 claude mcp add chromedebug -s user -- chromedebug-mcp
 ```
 
+#### Windows
+
+On Windows, use `cmd /c` to properly execute the server:
+
+```bash
+claude mcp add chromedebug -s user -- cmd /c chromedebug-mcp
+```
+
+**Note for Windows Users:** Process cleanup is currently limited on Windows. The server will start successfully but won't clean up orphaned processes from previous sessions. A full cross-platform process management solution is planned for a future release.
+
 ### Embedded HTTP Server
 
 Chrome Debug automatically starts an embedded HTTP server for Chrome extension communication. The server uses ports configured in `config/chrome-pilot-config.json` (default: 3001, 3000, 3002, 3028). The server provides these REST API endpoints:

package/chrome-extension/manifest.json

@@ -1,8 +1,8 @@
 {
   "manifest_version": 3,
-  "name": "ChromeDebug MCP Assistant v2.1.2",
-  "version": "2.1.2",
-  "description": "ChromeDebug MCP visual element selector with function tracing [Build: 2025-10-14-v2.1.2]",
+  "name": "ChromeDebug MCP Assistant v2.1.3",
+  "version": "2.1.3",
+  "description": "ChromeDebug MCP visual element selector with function tracing [Build: 2025-10-16-v2.1.3]",
   "permissions": [
     "activeTab",
     "scripting",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamicu/chromedebug-mcp",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "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",

package/scripts/package-webstore-extension.js

@@ -1,89 +1,118 @@
 #!/usr/bin/env node
-
-/**
- * Package FREE Chrome extension for Chrome Web Store distribution
- * Creates a .zip file optimized for Chrome Web Store submission
- */
-
-import { createWriteStream, promises as fs } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
 import archiver from 'archiver';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
 
 const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const rootDir = join(__dirname, '..');
-const freeExtensionDir = join(rootDir, 'scripts', 'dist', 'free');
-const outputDir = join(rootDir, 'dist');
-const outputFile = join(outputDir, 'chromedebug-webstore-free.zip');
-
-async function packageWebStoreExtension() {
-  console.log('📦 Building and packaging FREE Chrome extension for Web Store...');
-
-  // Step 1: Build the free version
-  console.log('🔨 Building free version...');
-  try {
-    execSync('npm run build:free', {
-      cwd: rootDir,
-      stdio: 'inherit'
-    });
-  } catch (error) {
-    console.error('❌ Failed to build free version');
-    throw error;
-  }
-
-  // Step 2: Verify the build output exists
-  try {
-    await fs.access(freeExtensionDir);
-  } catch {
-    throw new Error(`Build output not found at ${freeExtensionDir}`);
-  }
+const __dirname = path.dirname(__filename);
 
-  // Step 3: Ensure output directory exists
-  try {
-    await fs.mkdir(outputDir, { recursive: true });
-  } catch (error) {
-    // Directory might already exist, that's fine
-  }
+const projectRoot = path.join(__dirname, '..');
+const extensionDir = path.join(projectRoot, 'chrome-extension');
+const distDir = path.join(projectRoot, 'dist');
+const outputFile = path.join(distDir, 'chromedebug-extension-webstore.zip');
 
-  // Step 4: Create zip file optimized for Chrome Web Store
-  console.log('📦 Creating Chrome Web Store package...');
-
-  const output = createWriteStream(outputFile);
-  const archive = archiver('zip', {
-    zlib: { level: 9 }
-  });
-
-  return new Promise((resolve, reject) => {
-    output.on('close', () => {
-      const sizeKB = (archive.pointer() / 1024).toFixed(2);
-      console.log(`✅ Chrome Web Store package created successfully!`);
-      console.log(`   Size: ${sizeKB} KB`);
-      console.log(`   Location: ${outputFile}`);
-      console.log(`   📌 This is the FREE version for Chrome Web Store`);
-      console.log(`   🌐 Ready to upload to: https://chrome.google.com/webstore/devconsole`);
-      console.log(`\n📋 Next steps:`);
-      console.log(`   1. Go to Chrome Web Store Developer Dashboard`);
-      console.log(`   2. Upload this zip file`);
-      console.log(`   3. Fill in store listing details`);
-      console.log(`   4. Submit for review`);
-      resolve();
-    });
-
-    archive.on('error', reject);
-
-    archive.pipe(output);
-
-    // Add all files from the free build directory
-    // Chrome Web Store expects all files to be in the root of the zip
-    archive.directory(freeExtensionDir, false);
-
-    archive.finalize();
-  });
+// Ensure dist directory exists
+if (!fs.existsSync(distDir)) {
+  fs.mkdirSync(distDir, { recursive: true });
 }
 
-packageWebStoreExtension().catch(err => {
-  console.error('❌ Failed to package Chrome Web Store extension:', err);
-  process.exit(1);
+// Create output stream
+const output = fs.createWriteStream(outputFile);
+const archive = archiver('zip', { zlib: { level: 9 } });
+
+console.log('📦 Packaging Chrome extension for Web Store...');
+
+// Listen for archive events
+output.on('close', () => {
+  const sizeKB = (archive.pointer() / 1024).toFixed(2);
+  console.log(`✅ Extension packaged successfully!`);
+  console.log(`   File: ${outputFile}`);
+  console.log(`   Size: ${sizeKB} KB`);
+  console.log(`\n🚀 Ready to upload to Chrome Web Store!`);
+});
+
+archive.on('error', (err) => {
+  throw err;
+});
+
+// Pipe archive to output file
+archive.pipe(output);
+
+// Files to include in the extension (FREE version for Web Store)
+const filesToInclude = [
+  // Manifest (use FREE version and rename to manifest.json)
+  { source: 'manifest.free.json', target: 'manifest.json' },
+
+  // Background service worker
+  'background.js',
+  'chrome-session-manager.js',
+  'logger.js',
+  'extension-config.js',
+  'firebase-client.js',
+  'firebase-config.js',
+  'license-helper.js',
+
+  // Content scripts (from manifest)
+  'content.js',
+  'content.css',
+  'pako.min.js',
+  'web-vitals.iife.js',
+  'pii-redactor.js',
+  'data-buffer.js',
+  'performance-monitor.js',
+  'dom-tracker.js',
+  'network-tracker.js',
+
+  // Popup
+  'popup.html',
+  'popup.js',
+
+  // Options page
+  'options.html',
+  'options.js',
+
+  // Activation manager
+  'activation-manager.html',
+  'activation-manager.js',
+
+  // Offscreen
+  'offscreen.html',
+  'offscreen.js',
+
+  // Frame capture
+  'frame-capture.js',
+
+  // Icons
+  'icon16.png',
+  'icon48.png',
+  'icon128.png',
+
+  // Documentation
+  'README.md'
+];
+
+// Add each file to the archive
+filesToInclude.forEach(file => {
+  let sourcePath, targetName;
+
+  if (typeof file === 'object') {
+    // Handle object format { source: 'file.json', target: 'renamed.json' }
+    sourcePath = path.join(extensionDir, file.source);
+    targetName = file.target;
+  } else {
+    // Handle simple string format
+    sourcePath = path.join(extensionDir, file);
+    targetName = file;
+  }
+
+  if (fs.existsSync(sourcePath)) {
+    archive.file(sourcePath, { name: targetName });
+    console.log(`   ✓ ${targetName}${typeof file === 'object' ? ` (from ${file.source})` : ''}`);
+  } else {
+    console.warn(`   ⚠ Skipping missing file: ${typeof file === 'object' ? file.source : file}`);
+  }
 });
+
+// Finalize the archive
+archive.finalize();

package/src/services/process-manager.js

@@ -57,18 +57,30 @@ async function safeKillProcess(pid, signal = 'SIGTERM') {
 /**
  * Find ChromeDebug MCP processes using Node.js process list instead of shell commands
  * This prevents command injection while maintaining functionality
+ *
+ * NOTE: Windows support is intentionally limited - the ps command doesn't exist on Windows.
+ * Process cleanup is skipped on Windows to allow the server to start. A proper cross-platform
+ * solution will be implemented in a future update.
  */
 async function findChromePilotProcesses() {
+  // Skip process cleanup on Windows - ps command doesn't exist
+  // This allows the server to start on Windows without crashing
+  // TODO: Implement proper Windows process management using tasklist or Node.js process handles
+  if (process.platform === 'win32') {
+    console.log('[ChromeDebug] Process cleanup skipped on Windows (not yet implemented)');
+    return { pidsToKill: [], processDescriptions: [] };
+  }
+
   const currentPid = process.pid;
   const pidsToKill = [];
   const processDescriptions = [];
-  
+
   try {
     // Security: Use Node.js process list instead of shell commands
     // This approach uses the 'ps-list' module or similar safe approach
     // For now, we'll use a safer implementation with spawn instead of exec
     const { spawn } = await import('child_process');
-    
+
     return new Promise((resolve) => {
       const ps = spawn('ps', ['aux'], { stdio: ['ignore', 'pipe', 'ignore'] });
       let stdout = '';