@democratize-quality/mcp-server 1.1.9 → 1.2.0

package/cli.js

@@ -1,228 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Democratize Quality MCP Server CLI
- * Can be run via npx @democratize-quality/mcp-server
- */
-
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-
-// Handle CLI arguments
-const args = process.argv.slice(2);
-const isHelp = args.includes('--help') || args.includes('-h');
-const isVersion = args.includes('--version') || args.includes('-v');
-const isAgents = args.includes('--agents');
-
-if (isVersion) {
-    const packageJson = require('./package.json');
-    console.log(`Democratize Quality MCP Server v${packageJson.version}`);
-    process.exit(0);
-}
-
-// Handle agents installation
-if (isAgents) {
-    const AgentInstaller = require('./src/utils/agentInstaller');
-    const isVerbose = args.includes('--verbose') || args.includes('--debug');
-    const isRollback = args.includes('--rollback');
-    
-    (async () => {
-        try {
-            const installer = new AgentInstaller({ verbose: isVerbose });
-            
-            if (isRollback) {
-                await installer.rollback();
-            } else {
-                await installer.install();
-            }
-            
-            process.exit(0);
-        } catch (error) {
-            console.error('Installation failed:', error.message);
-            process.exit(1);
-        }
-    })();
-    return;
-}
-
-if (isVersion) {
-    const packageJson = require('./package.json');
-    console.log(`Democratize Quality MCP Server v${packageJson.version}`);
-    process.exit(0);
-}
-
-if (isHelp) {
-    console.log(`
-🎯 Democratize Quality MCP Server
-
-A comprehensive MCP server for democratizing quality through browser automation and API testing.
-
-Usage:
-  npx @democratize-quality/mcp-server [options]
-  democratize-quality-mcp [options]
-  dq-mcp-server [options]
-
-Options:
-  --help, -h                Show this help
-  --version, -v             Show version
-  --agents                  Install GitHub Copilot Chat agents and VS Code MCP configuration
-  --agents --rollback       Rollback agents installation (future feature)
-  --debug                   Enable debug mode
-  --verbose                 Enable verbose output (useful with --agents)
-  --port <number>           Set server port
-  --env <environment>       Set environment (development|production|api-only)
-
-Agent Installation:
-  --agents                  Installs API testing agents for GitHub Copilot Chat:
-                           • Copies chatmode files to .github/chatmodes/
-                           • Sets up MCP configuration in .vscode/mcp.json
-                           • Enables @🌐 api-planner, @🌐 api-generator, @🌐 api-healer agents
-  
-Tool Category Options:
-  --api-only                Enable only API tools (shortcut for api-only environment)
-  --browser-only            Enable only browser tools
-  --no-api                  Disable API tools
-  --no-browser              Disable browser tools
-  --no-advanced             Disable advanced browser tools
-  --enable-all              Enable all tool categories (default in development)
-
-Environment Variables:
-  MCP_FEATURES_ENABLEAPITOOLS=true/false        Enable/disable API tools
-  MCP_FEATURES_ENABLEBROWSERTOOLS=true/false    Enable/disable browser tools
-  MCP_FEATURES_ENABLEADVANCEDTOOLS=true/false   Enable/disable advanced tools
-  NODE_ENV=api-only                             Use API-only configuration
-
-Integration with Claude Desktop:
-Add this to ~/Library/Application Support/Claude/claude_desktop_config.json
-
-{
-  "mcpServers": {
-    "democratize-quality": {
-      "command": "npx",
-      "args": ["@democratize-quality/mcp-server"]
-    }
-  }
-}
-
-Or if installed globally:
-{
-  "mcpServers": {
-    "democratize-quality": {
-      "command": "democratize-quality-mcp"
-    }
-  }
-}
-
-Available Tools: 20
-• Browser Automation (17): launch, navigate, click, type, screenshot, pdf, etc.
-• API Testing (3): request, session status, HTML reports
-
-GitHub: https://github.com/democratize-quality/mcp-server
-`);
-    process.exit(0);
-}
-
-// Set up environment
-const env = { ...process.env };
-
-// Handle debug flag
-if (args.includes('--debug')) {
-    env.MCP_FEATURES_ENABLEDEBUGMODE = 'true';
-    env.NODE_ENV = 'development';
-}
-
-// Handle environment flag
-const envIndex = args.indexOf('--env');
-if (envIndex !== -1 && args[envIndex + 1]) {
-    env.NODE_ENV = args[envIndex + 1];
-}
-
-// Handle tool category flags
-if (args.includes('--api-only')) {
-    env.NODE_ENV = 'api-only';
-} else if (args.includes('--browser-only')) {
-    env.MCP_FEATURES_ENABLEAPITOOLS = 'false';
-    env.MCP_FEATURES_ENABLEBROWSERTOOLS = 'true';
-    env.MCP_FEATURES_ENABLEADVANCEDTOOLS = 'true';
-    env.MCP_FEATURES_ENABLEFILETOOLS = 'false';
-    env.MCP_FEATURES_ENABLENETWORKTOOLS = 'false';
-    env.MCP_FEATURES_ENABLEOTHERTOOLS = 'false';
-} else if (args.includes('--enable-all')) {
-    env.MCP_FEATURES_ENABLEAPITOOLS = 'true';
-    env.MCP_FEATURES_ENABLEBROWSERTOOLS = 'true';
-    env.MCP_FEATURES_ENABLEADVANCEDTOOLS = 'true';
-    env.MCP_FEATURES_ENABLEFILETOOLS = 'true';
-    env.MCP_FEATURES_ENABLENETWORKTOOLS = 'true';
-    env.MCP_FEATURES_ENABLEOTHERTOOLS = 'true';
-}
-
-// Handle individual tool category disable flags
-if (args.includes('--no-api')) {
-    env.MCP_FEATURES_ENABLEAPITOOLS = 'false';
-}
-if (args.includes('--no-browser')) {
-    env.MCP_FEATURES_ENABLEBROWSERTOOLS = 'false';
-}
-if (args.includes('--no-advanced')) {
-    env.MCP_FEATURES_ENABLEADVANCEDTOOLS = 'false';
-}
-
-// Handle port flag
-const portIndex = args.indexOf('--port');
-if (portIndex !== -1 && args[portIndex + 1]) {
-    env.PORT = args[portIndex + 1];
-}
-
-// Ensure output directory exists
-// When run via npx/Claude, process.cwd() might be root, so use home directory or temp
-const defaultOutputDir = env.HOME 
-    ? path.join(env.HOME, '.mcp-browser-control') 
-    : path.join(os.tmpdir(), 'mcp-browser-control');
-    
-const outputDir = env.OUTPUT_DIR || defaultOutputDir;
-if (!fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
-}
-env.OUTPUT_DIR = outputDir;
-
-// Debug output (if enabled)
-if (args.includes('--debug')) {
-    console.error(`📁 Output directory: ${outputDir}`);
-    console.error(`🏠 Working directory: ${process.cwd()}`);
-    console.error(`🌍 Environment: ${env.NODE_ENV || 'development'}`);
-    console.error(`🔧 Tool Categories:`);
-    console.error(`   API Tools: ${env.MCP_FEATURES_ENABLEAPITOOLS || 'default'}`);
-    console.error(`   Browser Tools: ${env.MCP_FEATURES_ENABLEBROWSERTOOLS || 'default'}`);
-    console.error(`   Advanced Tools: ${env.MCP_FEATURES_ENABLEADVANCEDTOOLS || 'default'}`);
-}
-
-// Start the MCP server
-const serverPath = path.join(__dirname, 'mcpServer.js');
-const serverProcess = spawn('node', [serverPath], {
-    env,
-    stdio: 'inherit'
-});
-
-// Handle process cleanup
-const cleanup = (signal) => {
-    console.error(`\nReceived ${signal}, shutting down gracefully...`);
-    serverProcess.kill(signal);
-};
-
-process.on('SIGINT', () => cleanup('SIGINT'));
-process.on('SIGTERM', () => cleanup('SIGTERM'));
-
-serverProcess.on('error', (error) => {
-    console.error('Failed to start CDP Browser Control MCP Server:', error.message);
-    process.exit(1);
-});
-
-serverProcess.on('exit', (code, signal) => {
-    if (signal) {
-        process.exit(0);
-    } else {
-        process.exit(code || 0);
-    }
-});

package/mcpServer.js

@@ -1,335 +0,0 @@
-#!/usr/bin/env node
-// mcpServer.js - Democratize Quality MCP Server entry point
-//
-// Debug/Logging Modes:
-// - Production mode (default): NODE_ENV=production or npm start - Minimal logging
-// - Debug mode: MCP_FEATURES_ENABLEDEBUGMODE=true or npm run dev - Detailed logging
-// - Development mode: NODE_ENV=development - Detailed logging (same as debug)
-//
-// The server automatically detects the mode and adjusts logging verbosity accordingly.
-
-const { JSONRPCServer } = require("json-rpc-2.0");
-const browserService = require('./src/services/browserService'); // Keep for shutdown functionality
-const { initializeTools, getToolDefinitions, executeTool } = require('./src/tools');
-const config = require('./src/config');
-
-// Initialize JSON-RPC server
-const server = new JSONRPCServer();
-
-// Check if debug mode is requested via environment variable first
-const debugFromEnv = process.env.MCP_FEATURES_ENABLEDEBUGMODE === 'true' || process.env.NODE_ENV === 'development';
-const isDebugMode = config.get('features.enableDebugMode', false) || debugFromEnv;
-
-// Set quiet mode if not in debug
-config.setQuiet(!isDebugMode);
-
-// Global variable to hold tool definitions after initialization
-let toolDefinitions = [];
-
-// Helper function for debug logging
-function debugLog(...args) {
-    if (isDebugMode) {
-        console.error('[Democratize Quality MCP]', ...args);
-    }
-}
-
-// Helper function for important logs (always shown)
-function log(...args) {
-    console.error('[Democratize Quality MCP]', ...args);
-}
-
-// Initialize the tool system
-async function initializeServer() {
-    try {
-        if (isDebugMode) {
-            log('Initializing tool system...');
-        }
-        await initializeTools(isDebugMode);
-        toolDefinitions = getToolDefinitions();
-        log(`Tool system initialized with ${toolDefinitions.length} tools`);
-    } catch (error) {
-        log('Failed to initialize tool system:', error.message);
-        process.exit(1);
-    }
-}
-
-// --- Register MCP Standard Methods ---
-
-// Initialize method for MCP protocol
-server.addMethod("initialize", async (params) => {
-    debugLog("Received 'initialize' request.");
-    return {
-        protocolVersion: "2024-11-05",
-        capabilities: {
-            tools: {},
-            prompts: {},
-            resources: {
-                subscribe: false,
-                listChanged: false
-            }
-        },
-        serverInfo: {
-            name: "democratize-quality-mcp-server",
-            version: "1.1.6"
-        }
-    };
-});
-
-// The `tools/list` method for tool discovery
-// Replace your tools/list method with this Draft 7 compatible version:
-
-server.addMethod("tools/list", async () => {
-    debugLog("Received 'tools/list' request.");
-    
-    // Convert all tool definitions to Claude Desktop compatible format
-    const compatibleTools = toolDefinitions.map(tool => {
-        // Ensure we use the correct property name and clean schema
-        return {
-            name: tool.name,
-            description: tool.description,
-            // Claude Desktop expects 'inputSchema', not 'input_schema'
-            inputSchema: {
-                type: "object",
-                properties: {
-                    // Add minimal properties to avoid empty schema issues
-                    ...((tool.input_schema && tool.input_schema.properties) || {}),
-                    // Fallback to ensure there's always at least one property
-                    ...(Object.keys((tool.input_schema && tool.input_schema.properties) || {}).length === 0 ? {
-                        _placeholder: { type: "string", description: "Placeholder parameter" }
-                    } : {})
-                },
-                // Only add required if it exists and is not empty
-                ...(tool.input_schema && tool.input_schema.required && tool.input_schema.required.length > 0 ? {
-                    required: tool.input_schema.required
-                } : {}),
-                // Ensure no additionalProperties or other Draft 2020-12 features
-                additionalProperties: false
-            }
-        };
-    });
-    
-    debugLog(`Returning ${compatibleTools.length} tools with compatible schemas`);
-    debugLog('First tool schema sample:', JSON.stringify(compatibleTools[0]?.inputSchema, null, 2));
-    
-    return { tools: compatibleTools };
-});
-
-// The `tools/call` method for tool invocation (note: it's tools/call, not tool/call)
-server.addMethod("tools/call", async ({ name, arguments: parameters }) => {
-    debugLog(`Received 'tools/call' for method: ${name} with params: ${JSON.stringify(parameters)}`);
-
-    try {
-        // Use the new tool system to execute the tool
-        const result = await executeTool(name, parameters);
-        return result;
-        
-    } catch (error) {
-        log(`Error executing tool '${name}':`, error.message);
-        
-        // If it's already a properly formatted MCP error, re-throw it
-        if (error.code && error.message) {
-            throw error;
-        }
-        
-        // Otherwise, format it as an MCP error
-        throw {
-            code: -32000,
-            message: `Tool execution failed: ${error.message}`,
-            data: { tool_name: name, original_error: error.message }
-        };
-    }
-});
-
-// The `prompts/list` method for prompt discovery
-server.addMethod("prompts/list", async () => {
-    debugLog("Received 'prompts/list' request.");
-    // This server doesn't provide any prompts, so return an empty array
-    return { prompts: [] };
-});
-
-// The `resources/list` method for resource discovery
-server.addMethod("resources/list", async () => {
-    debugLog("Received 'resources/list' request.");
-    
-    // Expose tools as resources so they can be inspected via tool: URIs
-    // This is needed for Claude Code's resource-based tool inspection
-    const toolResources = toolDefinitions.map(tool => ({
-        uri: `tool:${tool.name}`,
-        name: tool.name,
-        description: tool.description,
-        mimeType: "application/json"
-    }));
-    
-    debugLog(`Returning ${toolResources.length} tool resources`);
-    return { resources: toolResources };
-});
-
-// The `resources/read` method for reading resource content
-server.addMethod("resources/read", async ({ uri }) => {
-    debugLog(`Received 'resources/read' request for URI: ${uri}`);
-    
-    // Handle tool: URIs (e.g., tool:api_planner)
-    if (uri.startsWith('tool:')) {
-        const toolName = uri.substring(5); // Remove 'tool:' prefix
-        const tool = toolDefinitions.find(t => t.name === toolName);
-        
-        if (!tool) {
-            throw {
-                code: -32602,
-                message: `Tool resource not found: ${toolName}`,
-                data: { uri }
-            };
-        }
-        
-        // Return the tool definition as a resource
-        const toolInfo = {
-            name: tool.name,
-            description: tool.description,
-            inputSchema: tool.input_schema || tool.inputSchema
-        };
-        
-        debugLog(`Returning tool resource for: ${toolName}`);
-        return {
-            contents: [{
-                uri: uri,
-                mimeType: "application/json",
-                text: JSON.stringify(toolInfo, null, 2)
-            }]
-        };
-    }
-    
-    // Unknown URI scheme
-    throw {
-        code: -32602,
-        message: `Unsupported resource URI scheme: ${uri}`,
-        data: { uri }
-    };
-});
-
-// Notification methods (these don't return responses)
-server.addMethod("notifications/initialized", async () => {
-    debugLog("Received 'notifications/initialized' notification.");
-    // Notifications don't return responses
-});
-
-server.addMethod("notifications/cancelled", async ({ requestId, reason }) => {
-    debugLog(`Received 'notifications/cancelled' for request ${requestId}: ${reason}`);
-    // Notifications don't return responses
-});
-
-// Add a catch-all method handler for debugging
-server.addMethod("*", async (params, method) => {
-    debugLog(`Unknown method called: ${method}`);
-    throw {
-        code: -32601,
-        message: `Method '${method}' not found`
-    };
-});
-
-// --- STDIO Communication Loop ---
-// This part handles reading JSON-RPC requests from stdin and writing responses to stdout.
-
-let inputBuffer = '';
-
-process.stdin.on('data', (chunk) => {
-    inputBuffer += chunk.toString();
-
-    // Process messages delimited by newline. This is a common pattern for STDIO RPC.
-    // In a production-grade server, you'd want a more robust JSON stream parser
-    // to handle partial messages or multiple messages in one chunk.
-    let newlineIndex;
-    while ((newlineIndex = inputBuffer.indexOf('\n')) !== -1) {
-        const messageString = inputBuffer.substring(0, newlineIndex).trim();
-        inputBuffer = inputBuffer.substring(newlineIndex + 1);
-
-        if (messageString) { // Ensure it's not an empty line
-            try {
-                const jsonRpcRequest = JSON.parse(messageString);
-                debugLog(`Received request: ${JSON.stringify(jsonRpcRequest)}`);
-                
-                // Handle notifications (no response expected)
-                if (!jsonRpcRequest.id && jsonRpcRequest.method && jsonRpcRequest.method.startsWith('notifications/')) {
-                    server.receive(jsonRpcRequest).catch(err => {
-                        log("Error processing notification:", err.message);
-                    });
-                    return; // Don't send a response for notifications
-                }
-                
-                // The receive method handles processing the request and generating a response
-                server.receive(jsonRpcRequest).then((jsonRpcResponse) => {
-                    if (jsonRpcResponse) {
-                        debugLog(`Sending response: ${JSON.stringify(jsonRpcResponse)}`);
-                        // All responses must go to stdout
-                        process.stdout.write(JSON.stringify(jsonRpcResponse) + '\n');
-                    }
-                }).catch(err => {
-                    // Catch errors from receive() if it rejects (e.g., malformed JSON-RPC request)
-                    log("Error processing JSON-RPC request:", err.message);
-                    
-                    // Send an error response if we have an ID
-                    if (jsonRpcRequest.id) {
-                        const errorResponse = {
-                            jsonrpc: "2.0",
-                            error: {
-                                code: -32603,
-                                message: "Internal error",
-                                data: err.message
-                            },
-                            id: jsonRpcRequest.id
-                        };
-                        process.stdout.write(JSON.stringify(errorResponse) + '\n');
-                    }
-                });
-            } catch (parseError) {
-                log("JSON parse error on input:", messageString, parseError);
-                // If the input itself is not valid JSON, we can't get an ID, so ID is null
-                const errorResponse = {
-                    jsonrpc: "2.0",
-                    error: {
-                        code: -32700, // Parse error
-                        message: "Parse error"
-                    },
-                    id: null
-                };
-                process.stdout.write(JSON.stringify(errorResponse) + '\n');
-            }
-        }
-    }
-});
-
-// Handle graceful shutdown signals (Ctrl+C, termination)
-process.on('SIGINT', async () => {
-    log('\nSIGINT received. Shutting down...');
-    try {
-        await browserService.shutdownAllBrowsers();
-        log('All browser instances closed. Exiting gracefully.');
-    } catch (err) {
-        log('Error during graceful shutdown:', err.message);
-        process.exit(1); // Exit with error code
-    }
-    process.exit(0); // Exit successfully
-});
-
-process.on('SIGTERM', async () => {
-    log('\nSIGTERM received. Shutting down...');
-    try {
-        await browserService.shutdownAllBrowsers();
-        log('All browser instances closed. Exiting gracefully.');
-    } catch (err) {
-        log('Error during graceful shutdown:', err.message);
-        process.exit(1);
-    }
-    process.exit(0);
-});
-
-// Initialize the server and start listening
-(async () => {
-    await initializeServer();
-    
-    // Initial message to indicate server is ready (to stderr)
-    log(`Server started. Waiting for input on stdin.`);
-    if (isDebugMode) {
-        log(`To integrate with a host, provide the command: node ${__filename}`);
-        log(`Debug mode enabled - showing detailed logs`);
-    }
-})();

package/run-server.js

@@ -1,140 +0,0 @@
-#!/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');
-});