@eddym06/custom-chrome-mcp 1.0.8 → 1.2.0

package/.npmrc-github

@@ -0,0 +1,2 @@
+@eddym06:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

package/ANALISIS_PROBLEMAS.md

@@ -0,0 +1,189 @@
+# 📊 Análisis de Problemas Detectados
+
+## 🔴 Problema 1: El sistema de activación no funciona
+
+### Causa Raíz
+El protocolo MCP **NO actualiza automáticamente** la lista de herramientas después de que el servidor envía una respuesta. Cuando la IA inicia:
+
+1. **Primera petición**: Cliente pide lista de tools → Recibe 39 herramientas (core + control)
+2. **Llamada a activación**: IA llama `show_advanced_tools` → Server cambia flag `advancedToolsEnabled = true`
+3. **❌ PROBLEMA**: Cliente NO sabe que debe pedir la lista de nuevo
+4. **Resultado**: IA sigue trabajando con lista antigua de 39 tools
+5. **Síntoma**: IA dice "resend_network_request no está disponible" aunque el server lo activó
+
+### Solución Implementada: Notificaciones MCP
+
+```typescript
+// 1. Habilitar capability en el servidor
+capabilities: {
+  tools: {
+    listChanged: true,  // ✅ Indica que el servidor soporta notificar cambios
+  },
+}
+
+// 2. Enviar notificación cuando cambia la lista
+await server.notification({
+  method: 'notifications/tools/list_changed',
+  params: {}
+});
+```
+
+**Flujo corregido:**
+1. Cliente pide lista → 39 tools
+2. IA llama `show_advanced_tools`
+3. Server cambia flag + **ENVÍA NOTIFICACIÓN** 🔔
+4. Cliente recibe notificación → **Vuelve a pedir lista automáticamente**
+5. Cliente recibe nueva lista → 89 tools (39 core + 50 advanced)
+6. ✅ IA ahora puede ver y usar `resend_network_request`
+
+---
+
+## 🔴 Problema 2: `test_api_endpoint` fallaba con headers
+
+### Lo que pasó en el test de Copilot:
+
+```javascript
+// ❌ Copilot intentó pasar headers como STRING JSON
+test_api_endpoint({
+  url: "https://www.apple.com/search-services/suggestions/",
+  method: "POST",
+  body: "{...}",
+  headers: "{\"Content-Type\": \"application/json\"}"  // ❌ STRING
+})
+
+// Error: El código esperaba un OBJETO
+const headersObj = headers || {};  // ❌ Si headers es string, falla
+```
+
+### Causa Raíz
+El schema Zod solo aceptaba objetos:
+
+```typescript
+// ❌ ANTES
+headers: z.record(z.string()).optional()
+
+// ✅ AHORA  
+headers: z.union([z.record(z.string()), z.string()]).optional()
+```
+
+### Solución Implementada
+
+```typescript
+// Parse automático en el handler
+let headersObj = {};
+if (headers) {
+  if (typeof headers === 'string') {
+    try {
+      headersObj = JSON.parse(headers);  // Convierte string a objeto
+    } catch (e) {
+      throw new Error(`Invalid headers JSON string: ${e.message}`);
+    }
+  } else {
+    headersObj = headers;  // Ya es objeto
+  }
+}
+```
+
+**Ahora acepta ambos formatos:**
+- ✅ `headers: { "Content-Type": "application/json" }` (objeto)
+- ✅ `headers: "{\"Content-Type\": \"application/json\"}"` (string JSON)
+
+---
+
+## 📈 Impacto de las Correcciones
+
+### Antes:
+- ❌ Sistema de activación no funcionaba (notificaciones no implementadas)
+- ❌ `test_api_endpoint` fallaba si la IA pasaba strings
+- ❌ IA usaba `execute_script` + `fetch()` como fallback (bloqueado por validación)
+- ❌ IA no podía completar el workflow
+
+### Ahora:
+- ✅ Sistema de activación funcional con notificaciones MCP estándar
+- ✅ `test_api_endpoint` acepta headers/body flexibles
+- ✅ Cliente recibe actualización automática de lista de tools
+- ✅ IA puede descubrir y usar `resend_network_request` correctamente
+
+---
+
+## 🧪 Próxima Prueba
+
+Repetir el mismo test con Copilot:
+
+```
+Navega a apple.com, luego presiona un botón e intercepta el tráfico de red,
+y que manda ese paquete, luego vuelve a la página inicial, y ejecuta el 
+paquete que interceptaste y mándaselo a la página ver qué hace
+```
+
+**Resultado esperado:**
+1. ✅ `capture_network_on_action` captura el requestId
+2. ✅ `show_advanced_tools` activa y notifica
+3. ✅ Cliente actualiza lista automáticamente
+4. ✅ `resend_network_request` ahora visible y usable
+5. ✅ Workflow completo exitoso
+
+---
+
+## 🔧 Cambios Técnicos Aplicados
+
+### `src/index.ts`
+```typescript
+// ✅ Agregado: capabilities.tools.listChanged
+capabilities: {
+  tools: {
+    listChanged: true,
+  },
+}
+
+// ✅ Agregado: Notificación en show_advanced_tools
+await server.notification({
+  method: 'notifications/tools/list_changed',
+  params: {}
+});
+
+// ✅ Agregado: Notificación en hide_advanced_tools  
+await server.notification({
+  method: 'notifications/tools/list_changed',
+  params: {}
+});
+```
+
+### `src/tools/smart-workflows.ts`
+```typescript
+// ✅ Schema flexible para headers
+inputSchema: z.object({
+  headers: z.union([z.record(z.string()), z.string()]).optional(),
+  // ...
+})
+
+// ✅ Parser automático en handler
+let headersObj = {};
+if (headers) {
+  if (typeof headers === 'string') {
+    headersObj = JSON.parse(headers);
+  } else {
+    headersObj = headers;
+  }
+}
+```
+
+---
+
+## 📚 Referencias MCP
+
+- **Spec oficial**: `notifications/tools/list_changed` es una notificación estándar del protocolo MCP
+- **Capability**: `tools.listChanged: true` debe estar en `ServerCapabilities`
+- **Método**: `server.notification()` para enviar notificaciones al cliente
+- **Tipo**: `ToolListChangedNotification` con `params?: NotificationParams`
+
+---
+
+## ✅ Estado del Sistema
+
+**Compilación**: ✅ Exitosa  
+**Notificaciones MCP**: ✅ Implementadas  
+**Flexibilidad de inputs**: ✅ Mejorada  
+**Listo para prueba**: ✅ SÍ  
+
+Siguiente paso: **Prueba real con Copilot** para validar que el sistema de notificaciones funciona correctamente.

package/Backup Original/.npmrc-github

@@ -0,0 +1,2 @@
+@eddym06:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

package/Backup Original/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-01-07
+
+### ✨ Features
+
+#### Core
+- Initial release of Custom Chrome MCP
+- Connect to existing Chrome instances via CDP (port 9222)
+- Full MCP protocol implementation with 44 tools
+
+#### Navigation & Tabs (8 tools)
+- Navigate to URLs with wait conditions
+- Browser history (back/forward)
+- Page reload with cache options
+- Multi-tab management (list, create, close, switch)
+- Get current URL and page info
+
+#### Interaction (8 tools)
+- Click elements with human-like delays
+- Type text with realistic timing
+- Get text content and attributes
+- Execute custom JavaScript
+- Scroll pages and elements
+- Wait for selectors with timeout
+- Select options from dropdowns
+
+#### Anti-Detection (5 tools)
+- Stealth mode with navigator.webdriver masking
+- Custom user agent configuration
+- Viewport and device emulation
+- Geolocation spoofing
+- Timezone override
+
+#### Service Workers (9 tools)
+- List all registered service workers
+- Get detailed worker information
+- Unregister service workers
+- Force update registrations
+- Start/stop workers
+- Inspect workers in DevTools
+- Skip waiting phase
+- Manage service worker caches
+
+#### Capture & Export (5 tools)
+- Screenshots (PNG/JPEG, full page, custom areas)
+- Export to PDF
+- Get HTML content
+- Page layout metrics
+- Accessibility tree export
+
+#### Sessions & Cookies (9 tools)
+- Cookie management (get, set, delete, clear)
+- localStorage operations
+- sessionStorage support
+- Full session export/import
+- Cross-session persistence
+
+### 🛡️ Security
+- Anti-detection measures
+- Realistic browser fingerprinting
+- Human-like interaction patterns
+
+### 📚 Documentation
+- Comprehensive README
+- Usage examples
+- Troubleshooting guide
+- API documentation
+
+### 🔧 Technical
+- TypeScript implementation
+- Zod schema validation
+- Error handling
+- Graceful shutdown
+- Modular architecture
+
+## [Unreleased]
+
+### Planned Features
+- Visual regression testing
+- Network throttling
+- Performance profiling
+- Video recording
+- Auto-recovery mechanisms
+- Multi-profile support (future)

package/Backup Original/CONDITIONAL_DESCRIPTIONS.md

@@ -0,0 +1,174 @@
+# Conditional Description Patterns for All Tools
+
+## Philosophy: "When to Use" > "What it Does"
+
+AI models make better tool selection decisions when descriptions focus on **triggers** and **context** rather than just functionality.
+
+---
+
+## Pattern Templates
+
+### Pattern 1: Navigation Tools
+```
+[Tool Name] - [Primary Action]
+
+USE THIS WHEN:
+- User says "[trigger phrase 1]"
+- User says "[trigger phrase 2]"
+- [Contextual condition]
+
+WORKFLOW:
+1️⃣ [This tool] → 2️⃣ [Next logical step] → 3️⃣ [Then action]
+
+❌ DO NOT USE when [anti-pattern]
+✅ USE when [correct pattern]
+```
+
+### Pattern 2: Interaction Tools
+```
+[Tool Name] - [Primary Action]
+
+⚠️ PREREQUISITE: [Required step before this tool]
+
+USE THIS WHEN:
+- [User intent 1]
+- [User intent 2]
+
+PROPER WORKFLOW:
+1️⃣ [Analysis step] → 2️⃣ [This tool] → 3️⃣ [Verification]
+
+COMMON MISTAKE: [What AI typically gets wrong]
+```
+
+### Pattern 3: Analysis/Inspection Tools
+```
+[Tool Name] - [Primary Action]
+
+🔍 USE THIS WHEN:
+- [Symptom 1] (e.g., "content missing after click")
+- [Symptom 2] (e.g., "page loads but data empty")
+- [Symptom 3]
+
+WHY CRITICAL: [Explains the "why" - what's invisible without this tool]
+
+WHEN NOT TO USE: [Situations where simpler tool suffices]
+```
+
+### Pattern 4: Network/Debugging Tools
+```
+[Tool Name] - [Primary Action]
+
+🚨 USE THIS WHEN:
+- After [action], expected [result] doesn't appear
+- Suspecting [technical condition]
+- Need to [specific diagnostic]
+
+WORKFLOW STEP: [X] of [Y]
+PREVIOUS: [What should have been done before]
+NEXT: [What to do after]
+
+TROUBLESHOOTING: If [problem], this tool reveals [hidden information]
+```
+
+### Pattern 5: Configuration/Setup Tools
+```
+[Tool Name] - [Primary Action]
+
+⚙️ CONFIGURE BEFORE: [Type of operation]
+
+PARAMETERS AI SHOULD SET:
+- [param1]: [guidance on value selection]
+- [param2]: [guidance on value selection]
+
+TYPICAL VALUES:
+- Simple operations: [value]
+- Complex operations: [value]
+- Heavy operations: [value]
+```
+
+---
+
+## Application Strategy
+
+### Phase 1: Critical Path Tools (HIGH PRIORITY)
+Tools that are most commonly used and most likely to be misused:
+- ✅ navigate (DONE)
+- ✅ create_tab (DONE)
+- ✅ click (DONE)
+- ✅ type (DONE)
+- ✅ get_html (DONE)
+- ✅ screenshot (DONE)
+- ✅ execute_script (DONE)
+- ✅ enable_response_interception (DONE)
+- ✅ list_intercepted_responses (DONE)
+
+### Phase 2: Analysis & Debugging (MEDIUM PRIORITY)
+- get_text
+- get_attribute
+- wait_for_selector
+- list_tabs
+- get_url
+- get_cookies
+- list_all_targets
+- connect_to_target
+- execute_in_target
+
+### Phase 3: Advanced Network (MEDIUM PRIORITY)
+- modify_intercepted_response (partially done)
+- create_mock_endpoint
+- enable_websocket_interception
+- start_har_recording
+- export_har_file
+- inject_css_global
+- inject_js_global
+
+### Phase 4: Specialized Tools (LOWER PRIORITY)
+- Anti-detection tools
+- Service worker tools
+- Session management
+- Print to PDF
+- Storage tools
+
+---
+
+## Key Principles
+
+1. **Start with "WHEN"**: What triggers using this tool?
+2. **Explain "WHY"**: What's invisible/unclear without it?
+3. **Show "HOW"**: What's the workflow?
+4. **Warn against anti-patterns**: What mistakes do AIs make?
+5. **Guide parameters**: What values should AI choose?
+
+---
+
+## Examples Applied
+
+### Before (generic):
+```typescript
+name: 'get_cookies',
+description: 'Get all cookies for the current domain'
+```
+
+### After (conditional):
+```typescript
+name: 'get_cookies',
+description: `🔍 Retrieves browser cookies for current domain.
+
+USE THIS WHEN:
+- Debugging authentication issues (checking if auth token exists)
+- Session not persisting (verify session cookies)
+- Login appears successful but features unavailable (check cookie values)
+- Need to verify third-party cookies loaded
+
+WHY: Cookies often contain hidden auth/session data not visible in HTML.
+Many login/auth issues are cookie-related (expired, wrong domain, httpOnly).
+
+COMMON ISSUES DIAGNOSED:
+- "User logged in but still see login page" → Check auth cookie
+- "Cart items disappear" → Check session cookie
+- "Preferences not saving" → Check settings cookie`
+```
+
+---
+
+This pattern should be applied to ALL 84+ tools systematically.