@eddym06/custom-chrome-mcp 1.0.4 → 1.1.0

package/dist/utils/truncate.js

@@ -0,0 +1,46 @@
+/**
+ * Output Truncation Utilities
+ * Prevents overwhelming AI with massive outputs
+ */
+/**
+ * Truncates output intelligently with metadata
+ * @param data The data to potentially truncate
+ * @param maxSize Maximum size in characters (default: 50000)
+ * @param context Context hint for better suggestions
+ */
+export function truncateOutput(data, maxSize = 50000, context) {
+    if (data.length <= maxSize) {
+        return { truncated: false, data };
+    }
+    // Context-specific suggestions
+    const suggestions = {
+        html: 'Use get_html with specific selector (e.g., get_html({selector: ".main-content"})) to get smaller chunks. Or use execute_script with targeted querySelector.',
+        json: 'Use execute_script to filter/query the data before returning. Example: return data.filter(item => item.id < 10)',
+        network: 'Use more specific URL patterns in interception. Or filter by resourceType (XHR, Fetch only).',
+        text: 'Use more specific selectors or queries to extract only the needed portion.'
+    };
+    const suggestion = context ? suggestions[context] : 'Use more specific filters or selectors to reduce output size.';
+    return {
+        truncated: true,
+        totalSize: data.length,
+        truncatedSize: maxSize,
+        data: data.substring(0, maxSize),
+        message: `⚠️ Output truncated: ${data.length} chars → ${maxSize} chars (${Math.round((maxSize / data.length) * 100)}% shown)`,
+        suggestion
+    };
+}
+/**
+ * Truncates array outputs intelligently
+ */
+export function truncateArray(items, maxItems = 100, context) {
+    if (items.length <= maxItems) {
+        return { truncated: false, items };
+    }
+    return {
+        truncated: true,
+        totalCount: items.length,
+        items: items.slice(0, maxItems),
+        message: `⚠️ Array truncated: ${items.length} items → ${maxItems} items shown. ${context || 'Use more specific filters to see remaining items.'}`
+    };
+}
+//# sourceMappingURL=truncate.js.map

package/dist/utils/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../src/utils/truncate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,UAAkB,KAAK,EACvB,OAA8C;IAE9C,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,+BAA+B;IAC/B,MAAM,WAAW,GAA2B;QAC1C,IAAI,EAAE,6JAA6J;QACnK,IAAI,EAAE,iHAAiH;QACvH,OAAO,EAAE,8FAA8F;QACvG,IAAI,EAAE,4EAA4E;KACnF,CAAC;IAEF,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,+DAA+D,CAAC;IAEpH,OAAO;QACL,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,MAAM;QACtB,aAAa,EAAE,OAAO;QACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC;QAChC,OAAO,EAAE,wBAAwB,IAAI,CAAC,MAAM,YAAY,OAAO,WAAW,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAC,IAAI,CAAC,MAAM,CAAC,GAAC,GAAG,CAAC,UAAU;QACzH,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAU,EACV,WAAmB,GAAG,EACtB,OAAgB;IAEhB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QAC/B,OAAO,EAAE,uBAAuB,KAAK,CAAC,MAAM,YAAY,QAAQ,iBAAiB,OAAO,IAAI,mDAAmD,EAAE;KAClJ,CAAC;AACJ,CAAC"}

package/dist/verify-tools.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Tool Verification Script
+ * Verifies that all tools are properly exposed by the MCP server
+ */
+export {};
+//# sourceMappingURL=verify-tools.d.ts.map

package/dist/verify-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-tools.d.ts","sourceRoot":"","sources":["../src/verify-tools.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/verify-tools.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * Tool Verification Script
+ * Verifies that all tools are properly exposed by the MCP server
+ */
+import { createNavigationTools } from './tools/navigation.js';
+import { createInteractionTools } from './tools/interaction.js';
+import { createAdvancedNetworkTools } from './tools/advanced-network.js';
+// Mock connector (we don't need real Chrome connection for this test)
+const mockConnector = {};
+console.log('🔍 Verifying MCP Tool Exposure...\n');
+// Collect all tools
+const allTools = [
+    ...createNavigationTools(mockConnector),
+    ...createInteractionTools(mockConnector),
+    ...createAdvancedNetworkTools(mockConnector),
+];
+// Group by category
+const toolsByCategory = {
+    navigation: createNavigationTools(mockConnector),
+    interaction: createInteractionTools(mockConnector),
+    advancedNetwork: createAdvancedNetworkTools(mockConnector)
+};
+// Print summary
+console.log('📊 TOOL SUMMARY');
+console.log('═'.repeat(80));
+console.log(`Total Tools: ${allTools.length}\n`);
+for (const [category, tools] of Object.entries(toolsByCategory)) {
+    console.log(`\n${category.toUpperCase()} (${tools.length} tools):`);
+    console.log('─'.repeat(80));
+    tools.forEach((tool, index) => {
+        console.log(`  ${index + 1}. ${tool.name}`);
+    });
+}
+// Verify critical interception tools
+console.log('\n\n🔍 CRITICAL INTERCEPTION TOOLS VERIFICATION');
+console.log('═'.repeat(80));
+const criticalTools = [
+    'enable_response_interception',
+    'list_intercepted_responses',
+    'modify_intercepted_response',
+    'disable_response_interception',
+    'continue_intercepted_request',
+    'fail_intercepted_request'
+];
+const toolMap = new Map(allTools.map(t => [t.name, t]));
+let allFound = true;
+criticalTools.forEach(toolName => {
+    const found = toolMap.has(toolName);
+    const status = found ? '✅' : '❌';
+    console.log(`${status} ${toolName}`);
+    if (found) {
+        const tool = toolMap.get(toolName);
+        console.log(`   Description: ${tool.description.substring(0, 100)}...`);
+    }
+    else {
+        console.log(`   ⚠️  MISSING! This tool should exist but wasn't found!`);
+        allFound = false;
+    }
+    console.log();
+});
+// Verify navigation tools
+console.log('\n🧭 NAVIGATION TOOLS VERIFICATION');
+console.log('═'.repeat(80));
+const navigationTools = ['navigate', 'create_tab', 'go_back', 'go_forward', 'reload'];
+navigationTools.forEach(toolName => {
+    const found = toolMap.has(toolName);
+    const status = found ? '✅' : '❌';
+    console.log(`${status} ${toolName}`);
+    if (found && toolName === 'navigate') {
+        const tool = toolMap.get(toolName);
+        // Check if description includes PRIMARY NAVIGATION TOOL
+        if (tool.description.includes('PRIMARY NAVIGATION TOOL')) {
+            console.log('   ✅ Description includes "PRIMARY NAVIGATION TOOL"');
+        }
+        else {
+            console.log('   ⚠️  Description missing "PRIMARY NAVIGATION TOOL" marker');
+            allFound = false;
+        }
+    }
+    if (found && toolName === 'create_tab') {
+        const tool = toolMap.get(toolName);
+        // Check if description warns against using for simple navigation
+        if (tool.description.includes('DO NOT USE for simple navigation')) {
+            console.log('   ✅ Description includes "DO NOT USE for simple navigation"');
+        }
+        else {
+            console.log('   ⚠️  Description missing navigation warning');
+            allFound = false;
+        }
+    }
+});
+// Verify interaction tools have workflows
+console.log('\n\n🖱️  INTERACTION TOOLS WORKFLOW VERIFICATION');
+console.log('═'.repeat(80));
+const interactionTools = ['click', 'type', 'get_html', 'screenshot'];
+interactionTools.forEach(toolName => {
+    const found = toolMap.has(toolName);
+    const status = found ? '✅' : '❌';
+    console.log(`${status} ${toolName}`);
+    if (found) {
+        const tool = toolMap.get(toolName);
+        if (toolName === 'click' || toolName === 'type') {
+            // Should have get_html prerequisite
+            if (tool.description.includes('get_html') || tool.description.includes('PREREQUISITE')) {
+                console.log('   ✅ Has get_html prerequisite in description');
+            }
+            else {
+                console.log('   ⚠️  Missing get_html prerequisite warning');
+                allFound = false;
+            }
+        }
+        if (toolName === 'get_html') {
+            // Should mention it's for analysis before interaction
+            if (tool.description.includes('CRITICAL') || tool.description.includes('BEFORE')) {
+                console.log('   ✅ Marked as critical for pre-interaction analysis');
+            }
+            else {
+                console.log('   ⚠️  Missing critical analysis marker');
+                allFound = false;
+            }
+        }
+    }
+});
+// Final verdict
+console.log('\n\n' + '═'.repeat(80));
+if (allFound) {
+    console.log('✅ ALL TOOLS VERIFIED SUCCESSFULLY!');
+    console.log('✅ All critical tools exist and have proper descriptions');
+    process.exit(0);
+}
+else {
+    console.log('❌ VERIFICATION FAILED!');
+    console.log('❌ Some tools are missing or have incorrect descriptions');
+    process.exit(1);
+}
+//# sourceMappingURL=verify-tools.js.map

package/dist/verify-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-tools.js","sourceRoot":"","sources":["../src/verify-tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@eddym06/custom-chrome-mcp",
-  "version": "1.0.4",
-  "description": "Cross-platform Chrome MCP with enhanced features: connect to existing Chrome, anti-detection, service workers, session management, Shadow Profile system, and more. Works on Windows, Mac, and Linux.",
+  "version": "1.1.0",
+  "description": "Cross-platform Chrome MCP with response interception, request mocking, WebSocket interception, HAR recording/replay, CSS/JS injection, advanced patterns, accessibility tree, anti-detection, service workers, and more. Works on Windows, Mac, and Linux.",
   "main": "dist/index.js",
   "bin": {
     "custom-chrome-mcp": "./dist/index.js"
   },
   "type": "module",
   "publishConfig": {
-    "registry": "https://npm.pkg.github.com"
+    "access": "public"
   },
   "scripts": {
     "build": "tsc",