@dynamicu/chromedebug-mcp 2.2.0

package/scripts/config-manager.js

@@ -0,0 +1,280 @@
+#!/usr/bin/env node
+// Configuration management CLI for Chrome Debug
+import { configLoader } from '../src/config-loader.js';
+import { generateExtensionConfig } from './generate-extension-config.js';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+function showHelp() {
+  console.log(`
+Chrome Debug Configuration Manager
+
+Usage:
+  node scripts/config-manager.js <command> [options]
+
+Commands:
+  show                     - Display current configuration
+  list-ports              - Show current port configuration
+  set-http-ports <ports>  - Set HTTP server ports (comma-separated)
+  set-mcp-ports <ports>   - Set MCP server ports (comma-separated)  
+  set-scan-order <order>  - Set extension port scan order (httpFirst|mcpFirst|sequential)
+  set-timeout <ms>        - Set server discovery timeout in milliseconds
+  set-range <start> <end> - Set port discovery range
+  reset                   - Reset to default configuration
+  help                    - Show this help message
+
+Examples:
+  node scripts/config-manager.js list-ports
+  node scripts/config-manager.js set-http-ports 3001,3000,3002
+  node scripts/config-manager.js set-scan-order httpFirst
+  node scripts/config-manager.js set-timeout 5000
+  node scripts/config-manager.js set-range 3000 3030
+`);
+}
+
+function showConfig() {
+  const config = configLoader.loadConfig();
+  console.log('\n📋 Current Configuration:');
+  console.log(JSON.stringify(config, null, 2));
+}
+
+function listPorts() {
+  console.log('\n🔌 Current Port Configuration:');
+  console.log('HTTP Server Ports:', configLoader.getHttpServerPorts());
+  console.log('MCP Server Ports:', configLoader.getMcpServerPorts());
+  console.log('Extension Port List:', configLoader.getExtensionPortList());
+  console.log('Discovery Timeout:', configLoader.getDiscoveryTimeout() + 'ms');
+}
+
+function setHttpPorts(portsString) {
+  try {
+    const ports = portsString.split(',').map(p => parseInt(p.trim(), 10));
+    const invalidPorts = ports.filter(p => isNaN(p) || p < 1 || p > 65535);
+    
+    if (invalidPorts.length > 0) {
+      console.error('❌ Invalid ports:', invalidPorts);
+      return false;
+    }
+
+    const success = configLoader.updateConfig({
+      serverPorts: {
+        ...configLoader.loadConfig().serverPorts,
+        httpServer: {
+          ...configLoader.loadConfig().serverPorts.httpServer,
+          preferredPorts: ports
+        }
+      }
+    });
+
+    if (success) {
+      console.log('✅ HTTP server ports updated:', ports);
+      generateExtensionConfig();
+      return true;
+    }
+  } catch (error) {
+    console.error('❌ Error setting HTTP ports:', error.message);
+    return false;
+  }
+}
+
+function setMcpPorts(portsString) {
+  try {
+    const ports = portsString.split(',').map(p => parseInt(p.trim(), 10));
+    const invalidPorts = ports.filter(p => isNaN(p) || p < 1 || p > 65535);
+    
+    if (invalidPorts.length > 0) {
+      console.error('❌ Invalid ports:', invalidPorts);
+      return false;
+    }
+
+    const success = configLoader.updateConfig({
+      serverPorts: {
+        ...configLoader.loadConfig().serverPorts,
+        mcpServer: {
+          ...configLoader.loadConfig().serverPorts.mcpServer,
+          preferredPorts: ports
+        }
+      }
+    });
+
+    if (success) {
+      console.log('✅ MCP server ports updated:', ports);
+      generateExtensionConfig();
+      return true;
+    }
+  } catch (error) {
+    console.error('❌ Error setting MCP ports:', error.message);
+    return false;
+  }
+}
+
+function setScanOrder(order) {
+  const validOrders = ['httpFirst', 'mcpFirst', 'sequential'];
+  
+  if (!validOrders.includes(order)) {
+    console.error('❌ Invalid scan order. Must be one of:', validOrders.join(', '));
+    return false;
+  }
+
+  try {
+    const success = configLoader.updateConfig({
+      chromeExtension: {
+        ...configLoader.loadConfig().chromeExtension,
+        portScanOrder: order
+      }
+    });
+
+    if (success) {
+      console.log('✅ Port scan order updated:', order);
+      generateExtensionConfig();
+      return true;
+    }
+  } catch (error) {
+    console.error('❌ Error setting scan order:', error.message);
+    return false;
+  }
+}
+
+function setTimeout(timeoutMs) {
+  const timeout = parseInt(timeoutMs, 10);
+  
+  if (isNaN(timeout) || timeout < 100 || timeout > 30000) {
+    console.error('❌ Invalid timeout. Must be between 100ms and 30000ms');
+    return false;
+  }
+
+  try {
+    const success = configLoader.updateConfig({
+      chromeExtension: {
+        ...configLoader.loadConfig().chromeExtension,
+        serverDiscovery: {
+          ...configLoader.loadConfig().chromeExtension.serverDiscovery,
+          timeoutMs: timeout
+        }
+      }
+    });
+
+    if (success) {
+      console.log('✅ Discovery timeout updated:', timeout + 'ms');
+      generateExtensionConfig();
+      return true;
+    }
+  } catch (error) {
+    console.error('❌ Error setting timeout:', error.message);
+    return false;
+  }
+}
+
+function setRange(start, end) {
+  const startPort = parseInt(start, 10);
+  const endPort = parseInt(end, 10);
+  
+  if (isNaN(startPort) || isNaN(endPort) || startPort < 1 || endPort > 65535 || startPort >= endPort) {
+    console.error('❌ Invalid port range. Start must be < end, both between 1-65535');
+    return false;
+  }
+
+  try {
+    const success = configLoader.updateConfig({
+      serverPorts: {
+        ...configLoader.loadConfig().serverPorts,
+        discoveryRange: {
+          ...configLoader.loadConfig().serverPorts.discoveryRange,
+          start: startPort,
+          end: endPort
+        }
+      }
+    });
+
+    if (success) {
+      console.log(`✅ Discovery range updated: ${startPort}-${endPort}`);
+      generateExtensionConfig();
+      return true;
+    }
+  } catch (error) {
+    console.error('❌ Error setting range:', error.message);
+    return false;
+  }
+}
+
+function resetConfig() {
+  try {
+    const success = configLoader.updateConfig(configLoader.DEFAULT_CONFIG);
+    
+    if (success) {
+      console.log('✅ Configuration reset to defaults');
+      generateExtensionConfig();
+      return true;
+    }
+  } catch (error) {
+    console.error('❌ Error resetting configuration:', error.message);
+    return false;
+  }
+}
+
+// Main command handler
+switch (command) {
+  case 'show':
+    showConfig();
+    break;
+    
+  case 'list-ports':
+    listPorts();
+    break;
+    
+  case 'set-http-ports':
+    if (!args[1]) {
+      console.error('❌ Please provide ports (comma-separated)');
+      process.exit(1);
+    }
+    setHttpPorts(args[1]);
+    break;
+    
+  case 'set-mcp-ports':
+    if (!args[1]) {
+      console.error('❌ Please provide ports (comma-separated)');
+      process.exit(1);
+    }
+    setMcpPorts(args[1]);
+    break;
+    
+  case 'set-scan-order':
+    if (!args[1]) {
+      console.error('❌ Please provide scan order (httpFirst|mcpFirst|sequential)');
+      process.exit(1);
+    }
+    setScanOrder(args[1]);
+    break;
+    
+  case 'set-timeout':
+    if (!args[1]) {
+      console.error('❌ Please provide timeout in milliseconds');
+      process.exit(1);
+    }
+    setTimeout(args[1]);
+    break;
+    
+  case 'set-range':
+    if (!args[1] || !args[2]) {
+      console.error('❌ Please provide start and end ports');
+      process.exit(1);
+    }
+    setRange(args[1], args[2]);
+    break;
+    
+  case 'reset':
+    resetConfig();
+    break;
+    
+  case 'help':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+    
+  default:
+    console.error('❌ Unknown command:', command);
+    showHelp();
+    process.exit(1);
+}

package/scripts/generate-extension-config.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// Script to generate Chrome extension configuration from main config file
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { configLoader } from '../src/config-loader.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const EXTENSION_CONFIG_PATH = path.join(__dirname, '../chrome-extension/extension-config.js');
+
+function generateExtensionConfig() {
+  try {
+    const ports = configLoader.getExtensionPortList();
+    const timeout = configLoader.getDiscoveryTimeout();
+    
+    const configContent = `// Auto-generated configuration from Chrome Debug config
+// DO NOT EDIT MANUALLY - Run 'npm run update-extension-config' to regenerate
+
+const CHROMEDEBUG_CONFIG = {
+  ports: ${JSON.stringify(ports, null, 2)},
+  discoveryTimeout: ${timeout},
+  lastGenerated: '${new Date().toISOString()}'
+};
+
+// Export for use in extension scripts
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = CHROMEDEBUG_CONFIG;
+}
+
+// For browser environments
+if (typeof window !== 'undefined') {
+  window.CHROMEDEBUG_CONFIG = CHROMEDEBUG_CONFIG;
+}
+`;
+
+    fs.writeFileSync(EXTENSION_CONFIG_PATH, configContent);
+    console.log(`✅ Extension configuration generated at: ${EXTENSION_CONFIG_PATH}`);
+    console.log(`📊 Port list (${ports.length} ports):`, ports);
+    console.log(`⏱️  Discovery timeout: ${timeout}ms`);
+    
+    return true;
+  } catch (error) {
+    console.error('❌ Error generating extension configuration:', error.message);
+    return false;
+  }
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  generateExtensionConfig();
+}
+
+export { generateExtensionConfig };

package/scripts/setup-security.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+import { generateApiKey, listApiKeys, ROLES } from '../src/middleware/auth.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+console.log('=== Chrome Debug Security Setup ===\n');
+
+// Check if any API keys exist
+const existingKeys = listApiKeys();
+const adminKeys = existingKeys.filter(key => key.role === ROLES.ADMIN && key.active);
+
+if (adminKeys.length === 0) {
+  console.log('No active admin API keys found. Creating default admin key...\n');
+  
+  const adminKey = generateApiKey('Setup Admin', ROLES.ADMIN);
+  
+  console.log('✅ Admin API key created successfully!');
+  console.log(`\nAPI Key: ${adminKey.apiKey}`);
+  console.log('\n⚠️  IMPORTANT: Save this key securely! You won\'t see it again.\n');
+  
+  // Save to a temporary file for reference
+  const keyFile = path.join(__dirname, '../.admin-key.txt');
+  fs.writeFileSync(keyFile, `Admin API Key: ${adminKey.apiKey}\nCreated: ${new Date().toISOString()}\n`);
+  console.log(`Key also saved to: ${keyFile}`);
+  console.log('Delete this file after copying the key to a secure location.\n');
+} else {
+  console.log(`Found ${adminKeys.length} active admin key(s):\n`);
+  adminKeys.forEach(key => {
+    console.log(`- ${key.name} (created: ${key.createdAt})`);
+  });
+  console.log('\nNo new admin key created.\n');
+}
+
+console.log('Current API Keys:');
+console.log('================');
+const allKeys = listApiKeys();
+if (allKeys.length === 0) {
+  console.log('No API keys found.');
+} else {
+  allKeys.forEach(key => {
+    const status = key.active ? '✅ Active' : '❌ Revoked';
+    const lastUsed = key.lastUsed ? new Date(key.lastUsed).toLocaleString() : 'Never';
+    console.log(`${key.name} (${key.role}) - ${status} - Last used: ${lastUsed}`);
+  });
+}
+
+console.log('\nNext Steps:');
+console.log('===========');
+console.log('1. Copy your admin API key to a secure location');
+console.log('2. Set up environment variables (see .env.example)');
+console.log('3. Create additional API keys for your applications:');
+console.log('   curl -X POST http://localhost:3000/chrome-pilot/admin/api-keys \\');
+console.log('     -H "X-API-Key: YOUR_ADMIN_KEY" \\');
+console.log('     -H "Content-Type: application/json" \\');
+console.log('     -d \'{"name": "My App", "role": "user"}\'');
+console.log('4. Test authentication:');
+console.log('   curl -H "X-API-Key: YOUR_KEY" http://localhost:3000/chrome-pilot/auth-test');
+console.log('\nSee SECURITY.md for complete security documentation.');
+console.log('\n=== Setup Complete ===');