@democratize-quality/mcp-server 1.0.0

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@democratize-quality/mcp-server",
+  "version": "1.0.0",
+  "main": "mcpServer.js",
+  "bin": {
+    "democratize-quality-mcp": "cli.js",
+    "dq-mcp-server": "cli.js"
+  },
+  "files": [
+    "mcpServer.js",
+    "run-server.js",
+    "cli.js",
+    "browserControl.js",
+    "src/",
+    "docs/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node test-mcp.js",
+    "docs:generate": "node scripts/generate-docs.js",
+    "docs:watch": "nodemon scripts/generate-docs.js",
+    "docs:clean": "rm -rf docs/",
+    "start": "NODE_ENV=production node mcpServer.js",
+    "mcp": "NODE_ENV=production node mcpServer.js",
+    "mcp:debug": "MCP_FEATURES_ENABLEDEBUGMODE=true node mcpServer.js",
+    "dev": "MCP_FEATURES_ENABLEDEBUGMODE=true node mcpServer.js",
+    "server": "node run-server.js",
+    "server:debug": "node run-server.js --debug",
+    "server:prod": "node run-server.js --production",
+    "inspector": "npx @modelcontextprotocol/inspector node mcpServer.js",
+    "prepare-publish": "node prepare-publish.js",
+    "prepublishOnly": "npm run prepare-publish",
+    "postinstall": "echo '\n🎯 Democratize Quality MCP Server installed successfully!\n\nQuick start:\n  npx @democratize-quality/mcp-server --help\n  npx dq-mcp-server --help\n\nDocumentation: https://github.com/democratize-quality/mcp-server#readme\n'"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "browser-automation",
+    "api-testing",
+    "quality-assurance",
+    "testing",
+    "democratize-quality",
+    "chrome-devtools",
+    "end-to-end-testing"
+  ],
+  "author": "Raj Uppadhyay",
+  "license": "ISC",
+  "description": "MCP Server for democratizing quality through browser automation and comprehensive API testing capabilities",
+  "homepage": "https://github.com/uppadhyayraj/democratize-quality-mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uppadhyayraj/democratize-quality-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/uppadhyayraj/democratize-quality-mcp-server/issues"
+  },
+  "mcp": {
+    "server": {
+      "command": "node",
+      "args": [
+        "mcpServer.js"
+      ],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  },
+  "dependencies": {
+    "body-parser": "^2.2.0",
+    "chrome-launcher": "^1.2.0",
+    "chrome-remote-interface": "^0.33.3",
+    "express": "^5.1.0",
+    "json-rpc-2.0": "^1.7.1",
+    "zod": "^4.0.10"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.10"
+  }
+}

package/run-server.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+
+/**
+ * Democratize Quality MCP Server Startup Script
+ * Provides easy configuration and startup options
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+const options = {
+    debug: args.includes('--debug') || args.includes('-d'),
+    production: args.includes('--production') || args.includes('-p'),
+    help: args.includes('--help') || args.includes('-h')
+};
+
+if (options.help) {
+    console.log(`
+🎯 Democratize Quality MCP Server
+
+Usage: npm run server [options]
+   or: node run-server.js [options]
+
+Options:
+  --debug, -d       Enable debug mode with verbose logging
+  --production, -p  Run in production mode
+  --help, -h        Show this help message
+
+Environment Variables:
+  NODE_ENV         Set environment (development/production)
+  OUTPUT_DIR       Directory for screenshots, PDFs, reports
+  PORT             Server port (default: 3000)
+
+Integration Examples:
+
+1. Claude Desktop (add to claude_desktop_config.json):
+{
+  "mcpServers": {
+    "democratize-quality": {
+      "command": "node",
+      "args": ["${path.join(__dirname, 'mcpServer.js')}"]
+    }
+  }
+}
+
+2. MCP Inspector (for testing):
+npx @modelcontextprotocol/inspector node mcpServer.js
+
+3. Direct STDIO communication:
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node mcpServer.js
+
+Available Tools: 20 total
+- Browser Tools (17): automation, interaction, content capture
+- API Tools (3): HTTP testing, session management, reporting
+
+Repository: https://github.com/democratize-quality/mcp-server
+`);
+    process.exit(0);
+}
+
+// Set environment variables
+const env = { ...process.env };
+
+if (options.debug) {
+    env.MCP_FEATURES_ENABLEDEBUGMODE = 'true';
+    env.NODE_ENV = 'development';
+    console.log('🐛 Debug mode enabled');
+}
+
+if (options.production) {
+    env.NODE_ENV = 'production';
+    console.log('🏭 Production mode enabled');
+}
+
+if (!env.OUTPUT_DIR) {
+    env.OUTPUT_DIR = path.join(__dirname, 'output');
+}
+
+// Ensure output directory exists
+const fs = require('fs');
+if (!fs.existsSync(env.OUTPUT_DIR)) {
+    fs.mkdirSync(env.OUTPUT_DIR, { recursive: true });
+    console.log(`📁 Created output directory: ${env.OUTPUT_DIR}`);
+}
+
+console.log(`
+🚀 Starting CDP Browser Control MCP Server
+
+📊 Configuration:
+   Environment: ${env.NODE_ENV || 'development'}
+   Debug Mode:  ${env.MCP_FEATURES_ENABLEDEBUGMODE || 'false'}
+   Output Dir:  ${env.OUTPUT_DIR}
+
+🔧 Available Tools: 20
+   Browser Automation: 17 tools
+   API Testing:        3 tools
+
+🔗 Integration ready for:
+   • Claude Desktop
+   • MCP Inspector  
+   • Custom MCP clients
+
+💡 Use --help for integration examples
+`);
+
+// Start the server
+const serverPath = path.join(__dirname, 'mcpServer.js');
+const serverProcess = spawn('node', [serverPath], {
+    env,
+    stdio: 'inherit'
+});
+
+// Handle process events
+serverProcess.on('error', (error) => {
+    console.error('❌ Failed to start server:', error.message);
+    process.exit(1);
+});
+
+serverProcess.on('exit', (code, signal) => {
+    if (signal) {
+        console.log(`\n👋 Server stopped by signal: ${signal}`);
+    } else if (code !== 0) {
+        console.error(`❌ Server exited with code: ${code}`);
+        process.exit(code);
+    } else {
+        console.log('\n👋 Server stopped gracefully');
+    }
+});
+
+// Forward signals to server
+process.on('SIGINT', () => {
+    console.log('\n⏹️  Stopping server...');
+    serverProcess.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+    serverProcess.kill('SIGTERM');
+});

package/src/config/environments/api-only.js

@@ -0,0 +1,53 @@
+/**
+ * API-only environment configuration
+ * Only enables API testing tools, disables all browser automation tools
+ * Ideal for lightweight deployments focused on API testing
+ */
+module.exports = {
+    features: {
+        enableDebugMode: process.env.MCP_FEATURES_ENABLEDEBUGMODE === 'true',
+        // Only API tools enabled
+        enableApiTools: true,
+        enableBrowserTools: false,
+        enableAdvancedTools: false,
+        enableFileTools: false,
+        enableNetworkTools: false,
+        enableOtherTools: false
+    },
+    
+    logging: {
+        level: 'warn',
+        enableToolDebug: false
+    },
+    
+    tools: {
+        validationLevel: 'strict',
+        // API tool specific configurations
+        api: {
+            api_request: {
+                maxSessionTimeout: 300000, // 5 minutes
+                maxConcurrentSessions: 10,
+                enableRetries: true,
+                defaultRetryAttempts: 3,
+                enableRequestLogging: true,
+                enableResponseLogging: true
+            },
+            api_session_report: {
+                defaultTheme: 'light',
+                includeTimestamp: true,
+                maxReportSize: '10MB',
+                enableCompressionForLargeReports: true
+            },
+            api_session_status: {
+                enableRealTimeUpdates: true,
+                maxHistoryEntries: 1000
+            }
+        }
+    },
+    
+    security: {
+        enableInputValidation: true,
+        rateLimiting: true,
+        maxRequestsPerMinute: 100
+    }
+};

package/src/config/environments/development.js

@@ -0,0 +1,54 @@
+/**
+ * Development environment configuration
+ * Settings optimized for development and debugging
+ */
+module.exports = {
+    features: {
+        enableDebugMode: true,
+        // Tool category feature flags - all enabled by default in development
+        enableApiTools: true,
+        enableBrowserTools: true,
+        enableAdvancedTools: true,
+        enableFileTools: true,
+        enableNetworkTools: true,
+        enableOtherTools: true
+    },
+    
+    logging: {
+        level: 'debug',
+        enableToolDebug: true
+    },
+    
+    tools: {
+        validationLevel: 'strict',
+        browser: {
+            browser_launch: {
+                defaultHeadless: false, // Show browser in development
+                maxInstances: 5,
+                chromeFlags: [
+                    '--disable-gpu',
+                    '--no-sandbox',
+                    '--disable-web-security', // Allow CORS in development
+                    '--disable-features=VizDisplayCompositor'
+                ]
+            },
+            browser_screenshot: {
+                enableTimestamps: true,
+                outputDirectory: require('path').resolve(__dirname, '../../../output/dev')
+            },
+            browser_dom: {
+                highlightElements: true, // Highlight elements for debugging
+                enableRetries: true
+            },
+            global: {
+                enableScreenshotOnError: true,
+                enablePerformanceMetrics: true
+            }
+        }
+    },
+    
+    security: {
+        enableInputValidation: true,
+        rateLimiting: false
+    }
+};

package/src/config/environments/production.js

@@ -0,0 +1,69 @@
+/**
+ * Production environment configuration
+ * Settings optimized for production deployment
+ */
+module.exports = {
+    features: {
+        enableDebugMode: false,
+        // Tool category feature flags - API tools enabled by default, others can be controlled
+        enableApiTools: true,
+        enableBrowserTools: process.env.ENABLE_BROWSER_TOOLS !== 'false',
+        enableAdvancedTools: process.env.ENABLE_ADVANCED_TOOLS === 'true',
+        enableFileTools: process.env.ENABLE_FILE_TOOLS === 'true',
+        enableNetworkTools: process.env.ENABLE_NETWORK_TOOLS === 'true',
+        enableOtherTools: process.env.ENABLE_OTHER_TOOLS === 'true'
+    },
+    
+    logging: {
+        level: 'error',
+        enableToolDebug: false
+    },
+    
+    tools: {
+        validationLevel: 'strict',
+        browser: {
+            browser_launch: {
+                defaultHeadless: true, // Always headless in production
+                maxInstances: 3, // Conservative limit
+                launchTimeout: 15000, // Shorter timeout
+                chromeFlags: [
+                    '--headless=new',
+                    '--disable-gpu',
+                    '--no-sandbox',
+                    '--disable-dev-shm-usage',
+                    '--disable-background-timer-throttling',
+                    '--disable-backgrounding-occluded-windows',
+                    '--disable-renderer-backgrounding',
+                    '--memory-pressure-off',
+                    '--max_old_space_size=4096'
+                ]
+            },
+            browser_screenshot: {
+                defaultQuality: 60, // Lower quality for performance
+                compressionLevel: 9, // Higher compression
+                enableTimestamps: false
+            },
+            browser_dom: {
+                highlightElements: false,
+                enableRetries: false, // Fail fast in production
+                defaultWaitTimeout: 3000 // Shorter timeout
+            },
+            browser_type: {
+                typingDelay: 5, // Faster typing
+                enableNaturalTyping: false
+            },
+            global: {
+                maxConcurrentOperations: 2,
+                enableScreenshotOnError: false,
+                enablePerformanceMetrics: false,
+                healthCheckInterval: 300000 // 5 minutes
+            }
+        }
+    },
+    
+    security: {
+        enableInputValidation: true,
+        rateLimiting: true,
+        maxRequestSize: '5MB'
+    }
+};