@dynamicu/chromedebug-mcp 2.4.0 → 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:
@@ -102,10 +112,35 @@ Chrome Debug includes a Chrome extension that enables visual element selection f
 
 ### Installing the Extension
 
+#### Option 1: Chrome Web Store (Recommended - FREE Version)
+
+Install the FREE version directly from the Chrome Web Store:
+
+🌐 **[Install from Chrome Web Store](https://chromewebstore.google.com/detail/lemgbmdnephoaniipapgeciebfeakffn?utm_source=item-share-cb)**
+
+- ✅ 5 recordings per day
+- ✅ Full MCP integration
+- ✅ Visual element selection
+- ✅ Automatic updates
+- ✅ No manual installation needed
+
+#### Option 2: Manual Installation (Development)
+
 1. Open Chrome and navigate to `chrome://extensions/`
-2. Enable "Developer mode" 
+2. Enable "Developer mode"
 3. Click "Load unpacked" and select the `chrome-extension` directory
 
+#### Option 3: PRO Version (Unlimited)
+
+For unlimited recordings and advanced features, purchase the PRO version:
+
+💎 **[Get PRO Version](https://dynamicu.lemonsqueezy.com/buy/641143)**
+
+- ✅ Unlimited recordings
+- ✅ Advanced function tracing
+- ✅ Enhanced capture features
+- ✅ Priority support
+
 ### Using the Extension
 
 1. **Element Selection**

package/chrome-extension/manifest.free.json

@@ -1,8 +1,8 @@
 {
   "manifest_version": 3,
-  "name": "ChromeDebug MCP Assistant FREE v2.1.1",
-  "version": "2.1.1",
-  "description": "ChromeDebug MCP visual element selector [FREE Edition] [Build: 2025-01-20-v2.1.1]",
+  "name": "ChromeDebug MCP Assistant FREE v2.4.0",
+  "version": "2.4.0",
+  "description": "ChromeDebug MCP visual element selector [FREE Edition] [Build: 2025-01-20-v2.4.0]",
   "permissions": [
     "activeTab",
     "scripting",

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.0",
+  "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",
@@ -56,7 +56,9 @@
     "tbv:microtest": "cd chrome-extension && npm run tbv:microtest",
     "build:free": "webpack --config scripts/webpack.config.free.cjs",
     "build:pro": "webpack --config scripts/webpack.config.pro.cjs",
-    "build:both": "npm run build:free && npm run build:pro"
+    "build:both": "npm run build:free && npm run build:pro",
+    "package-pro": "node scripts/package-pro-extension.js",
+    "package-webstore": "node scripts/package-webstore-extension.js"
   },
   "keywords": [
     "mcp",

package/scripts/package-pro-extension.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+/**
+ * Package PRO Chrome extension for LemonSqueezy distribution
+ * Creates a .zip file with the PRO version including activation manager
+ */
+
+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';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, '..');
+const proExtensionDir = join(rootDir, 'scripts', 'dist', 'pro');
+const outputDir = join(rootDir, 'dist');
+const outputFile = join(outputDir, 'chromedebug-extension-pro.zip');
+
+async function packageProExtension() {
+  console.log('📦 Building and packaging PRO Chrome extension...');
+
+  // Step 1: Build the pro version
+  console.log('🔨 Building PRO version...');
+  try {
+    execSync('npm run build:pro', {
+      cwd: rootDir,
+      stdio: 'inherit'
+    });
+  } catch (error) {
+    console.error('❌ Failed to build PRO version');
+    throw error;
+  }
+
+  // Step 2: Verify the build output exists
+  try {
+    await fs.access(proExtensionDir);
+  } catch {
+    throw new Error(`Build output not found at ${proExtensionDir}`);
+  }
+
+  // Step 3: Ensure output directory exists
+  try {
+    await fs.mkdir(outputDir, { recursive: true });
+  } catch (error) {
+    // Directory might already exist, that's fine
+  }
+
+  // Step 4: Create zip file
+  console.log('📦 Creating PRO zip 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(`✅ PRO extension packaged successfully!`);
+      console.log(`   Size: ${sizeKB} KB`);
+      console.log(`   Location: ${outputFile}`);
+      console.log(`   📌 This is the PRO version with activation manager`);
+      console.log(`   🔒 For LemonSqueezy distribution only`);
+      resolve();
+    });
+
+    archive.on('error', reject);
+
+    archive.pipe(output);
+
+    // Add all files from the pro build directory
+    archive.directory(proExtensionDir, false);
+
+    archive.finalize();
+  });
+}
+
+packageProExtension().catch(err => {
+  console.error('❌ Failed to package PRO extension:', err);
+  process.exit(1);
+});

package/scripts/package-webstore-extension.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+import archiver from 'archiver';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+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');
+
+// Ensure dist directory exists
+if (!fs.existsSync(distDir)) {
+  fs.mkdirSync(distDir, { recursive: true });
+}
+
+// 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 = '';