hakalab-mcp 2.0.0 → 2.0.1

package/README.md

@@ -1,208 +1,228 @@
-# Hakalab-Selenium-MCP
+# Hakalab-MCP v2.0
 
-Este MCP (Model Context Protocol) está diseñado específicamente para trabajar con el framework de pruebas de Selenium de Haka Lab, siguiendo sus patrones y estructura establecidos.
+**Servidor MCP completo para automatización web con Selenium y Playwright**
 
-## 🚀 Características
+[![npm version](https://img.shields.io/npm/v/hakalab-mcp.svg)](https://www.npmjs.com/package/hakalab-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-- **Creación automática de suites de pruebas** completas (Feature + Steps + Page Objects)
-- **Ejecución de pruebas** con filtros por tags y archivos específicos
-- **Generación de reportes Allure** integrada
-- **Sanitización y validación** de archivos de prueba
-- **Gestión de Page Objects** independientes
-- **Listado y organización** de archivos de prueba
+## 🚀 Descripción
 
-## 📋 Herramientas Disponibles
+Hakalab-MCP es un servidor Model Context Protocol (MCP) que proporciona automatización web completa con soporte para **Selenium** y **Playwright**. Incluye 20 herramientas para controlar navegadores, interactuar con elementos, y crear suites de pruebas automatizadas.
 
-### 1. `create_test_suite`
-Crea una suite completa de pruebas siguiendo los patrones del framework.
+## ✨ Características
 
-**Parámetros:**
-- `feature_name` (string): Nombre del feature
-- `scenarios` (array): Lista de escenarios con steps
-- `page_elements` (array, opcional): Elementos para Page Object
-- `tags` (array, opcional): Tags del feature
+- ✅ **Doble Motor**: Selenium WebDriver + Playwright
+- ✅ **Múltiples Navegadores**: Chrome, Firefox, Edge, Safari, Chromium, WebKit
+- ✅ **20 Herramientas**: Gestión completa de navegadores e interacciones
+- ✅ **Múltiples Selectores**: CSS, XPath, ID, Name, Class, Tag
+- ✅ **Esperas Inteligentes**: Configurable por herramienta
+- ✅ **Modo Headless**: Para ejecución sin interfaz
+- ✅ **Screenshots**: Capturas automáticas con timestamp
+- ✅ **Framework BDD**: Integración con Behave y Allure
+- ✅ **Súper Liviano**: Solo 13.7 KB
 
-**Ejemplo:**
-```json
-{
-  "feature_name": "Login de Usuario",
-  "scenarios": [
-    {
-      "name": "Login exitoso",
-      "description": "Usuario se autentica correctamente",
-      "tags": ["critical", "selenium"],
-      "steps": [
-        "Given ingreso a la página de login",
-        "When ingreso usuario \"admin\"",
-        "And ingreso contraseña \"password123\"",
-        "And hago click en iniciar sesión",
-        "Then veo el dashboard principal"
-      ]
-    }
-  ],
-  "page_elements": [
-    {
-      "name": "txt_usuario",
-      "type": "ID",
-      "locator": "username"
-    },
-    {
-      "name": "txt_password",
-      "type": "ID", 
-      "locator": "password"
-    },
-    {
-      "name": "btn_login",
-      "type": "XPATH",
-      "locator": "//button[@type='submit']"
-    }
-  ],
-  "tags": ["login", "authentication"]
-}
-```
+## 📦 Instalación
 
-### 2. `execute_tests`
-Ejecuta pruebas del framework con filtros opcionales.
+### Opción 1: Uso Directo con npx (Recomendado)
 
-**Parámetros:**
-- `tags` (array, opcional): Tags para filtrar (ej: ["selenium", "critical"])
-- `feature_file` (string, opcional): Archivo específico a ejecutar
-- `parallel` (boolean, opcional): Ejecución paralela
+No requiere instalación previa. Simplemente agrega la configuración a tu cliente MCP:
 
-**Ejemplo:**
 ```json
 {
-  "tags": ["selenium", "critical"],
-  "parallel": false
+  "mcpServers": {
+    "hakalab-mcp": {
+      "command": "npx",
+      "args": ["-y", "hakalab-mcp"]
+    }
+  }
 }
 ```
 
-### 3. `generate_allure_report`
-Genera el reporte de Allure después de ejecutar pruebas.
+### Opción 2: Instalación Global
 
-### 4. `sanitize_tests`
-Valida y sanitiza archivos de prueba, detectando problemas comunes.
+```bash
+npm install -g hakalab-mcp
+```
 
-### 5. `create_page_object`
-Crea un Page Object independiente.
+### Opción 3: Instalación Local
 
-**Parámetros:**
-- `page_name` (string): Nombre de la página
-- `elements` (array): Lista de elementos
+```bash
+npm install hakalab-mcp
+```
 
-### 6. `list_test_files`
-Lista archivos del framework por tipo.
+## 🔧 Configuración
 
-**Parámetros:**
-- `file_type` (string): "feature", "steps", "pages", o "all"
+### Para Kiro IDE
 
-## 🛠️ Instalación y Configuración
+Agrega esta configuración a `~/.kiro/settings/mcp.json`:
 
-### 1. Instalar dependencias
-```bash
-pip install -r requirements_mcp.txt
+```json
+{
+  "mcpServers": {
+    "hakalab-mcp": {
+      "command": "npx",
+      "args": ["-y", "hakalab-mcp"],
+      "disabled": false,
+      "autoApprove": [
+        "open_browser",
+        "close_browser",
+        "navigate_to_url",
+        "click_element",
+        "fill_input",
+        "take_screenshot"
+      ]
+    }
+  }
+}
 ```
 
-### 2. Configurar en Kiro
-Copia el contenido de `mcp_config.json` a tu archivo de configuración MCP de Kiro:
+### Para Claude Desktop
 
-**Para workspace específico:**
-```bash
-# Crear/editar .kiro/settings/mcp.json
-```
+Agrega esta configuración a `~/.claude_desktop_config.json`:
 
-**Para configuración global:**
-```bash
-# Editar ~/.kiro/settings/mcp.json
+```json
+{
+  "mcpServers": {
+    "hakalab-mcp": {
+      "command": "npx",
+      "args": ["-y", "hakalab-mcp"]
+    }
+  }
+}
 ```
 
-### 3. Verificar instalación
-En Kiro, ejecuta:
+## 🛠️ Herramientas Disponibles (20 Total)
+
+### 🌐 Gestión de Navegadores (6)
+- `open_browser` - Abre un navegador con Selenium o Playwright
+- `close_browser` - Cierra el navegador actual
+- `navigate_to_url` - Navega a una URL específica
+- `go_back` - Navega hacia atrás en el historial
+- `go_forward` - Navega hacia adelante en el historial
+- `refresh_page` - Recarga la página actual
+
+### 🎯 Interacciones Básicas (6)
+- `click_element` - Hace clic en un elemento
+- `double_click_element` - Hace doble clic en un elemento
+- `right_click_element` - Hace clic derecho en un elemento
+- `fill_input` - Completa un campo de texto
+- `select_option` - Selecciona una opción en un select/combobox
+- `hover_element` - Pasa el mouse sobre un elemento
+
+### 🔧 Interacciones Avanzadas (4)
+- `drag_and_drop` - Arrastra un elemento y lo suelta en otro
+- `scroll_to_element` - Hace scroll hasta un elemento
+- `take_screenshot` - Toma una captura de pantalla
+- `get_current_url` - Obtiene la URL actual
+- `get_page_title` - Obtiene el título de la página
+
+### 🧪 Framework BDD (6)
+- `create_test_suite` - Crea suite completa (feature, steps, page object)
+- `execute_tests` - Ejecuta pruebas del framework
+- `list_test_files` - Lista archivos de prueba
+- `create_page_object` - Crea un Page Object independiente
+- `sanitize_tests` - Valida archivos de prueba
+- `generate_allure_report` - Genera reporte de Allure
+
+## 📝 Ejemplos de Uso
+
+### Ejemplo 1: Búsqueda en Google
+
 ```
-Listar herramientas MCP disponibles
+1. "Abre Chrome con Playwright"
+2. "Ve a https://www.google.com"
+3. "Completa el campo de búsqueda con 'hola mundo'"
+4. "Haz click en el botón de búsqueda"
+5. "Toma una captura de pantalla"
+6. "Cierra el navegador"
 ```
 
-Deberías ver las 6 herramientas del Hakalab-Selenium-MCP.
-
-## 📁 Estructura Generada
-
-El MCP mantiene la estructura del framework original:
+### Ejemplo 2: Automatización de Formulario
 
 ```
-framework/
-├── features/
-│   ├── __init__.py
-│   ├── *.feature                 # Archivos Gherkin
-│   └── steps/
-│       ├── __init__.py
-│       └── *_steps.py           # Implementación de steps
-├── helper/
-│   └── pages/
-│       ├── __init__.py
-│       └── page_*.py            # Page Objects
-└── allure-results/              # Resultados de ejecución
+1. "Abre Firefox con Selenium"
+2. "Ve a https://example.com/form"
+3. "Completa el campo 'nombre' con 'Juan'"
+4. "Completa el campo 'email' con 'juan@example.com'"
+5. "Selecciona 'Opción 1' en el combobox"
+6. "Haz click en el botón 'Enviar'"
+7. "Toma una captura del resultado"
 ```
 
-## 🎯 Casos de Uso Comunes
+### Ejemplo 3: Interacciones Complejas
 
-### Crear una nueva funcionalidad completa
 ```
-Usar herramienta: create_test_suite
-- Definir feature name
-- Agregar escenarios con steps
-- Incluir elementos de página
-- Especificar tags apropiados
+1. "Abre Chrome con Playwright en modo headless"
+2. "Ve a https://example.com"
+3. "Pasa el mouse sobre el menú principal"
+4. "Haz click en 'Productos'"
+5. "Haz scroll hasta el producto deseado"
+6. "Arrastra el producto al carrito"
+7. "Toma una captura"
 ```
 
-### Ejecutar pruebas de regresión
-```
-Usar herramienta: execute_tests
-- Tags: ["selenium", "regression"]
-- Generar reporte después
-```
+## 📋 Requisitos
 
-### Validar calidad del código de pruebas
-```
-Usar herramienta: sanitize_tests
-- Revisa sintaxis Gherkin
-- Valida imports de Python
-- Detecta problemas comunes
-```
+- **Node.js**: 18.0.0 o superior
+- **npm**: 8.0.0 o superior
+- **Navegadores**: Chrome, Firefox, Edge, Safari (según el motor)
+
+## 🎯 Casos de Uso
+
+- ✅ Automatización de pruebas web
+- ✅ Web scraping
+- ✅ Pruebas de regresión
+- ✅ Pruebas de UI
+- ✅ Automatización de tareas repetitivas
+- ✅ Validación de funcionalidad
+- ✅ Pruebas de compatibilidad
+
+## 🐛 Solución de Problemas
+
+### Error: "Browser not found"
+- Asegúrate de tener el navegador instalado
+- Para Playwright: ejecuta `npx playwright install`
+
+### Error: "Timeout waiting for element"
+- Aumenta el `wait_time` en los parámetros
+- Verifica que el selector sea correcto
+
+### Error: "Connection refused"
+- Verifica que el MCP esté correctamente configurado
+- Reinicia tu cliente MCP
+
+## 📚 Documentación Completa
+
+Para documentación detallada, consulta [README_MCP.md](README_MCP.md)
+
+## 🤝 Contribuciones
 
-## 🔧 Integración con el Framework
+Las contribuciones son bienvenidas. Por favor:
 
-El MCP respeta completamente los patrones del framework:
+1. Fork el repositorio
+2. Crea una rama para tu feature
+3. Commit tus cambios
+4. Push a la rama
+5. Abre un Pull Request
 
-- **Behave + Gherkin**: Genera archivos .feature válidos
-- **Page Object Model**: Crea clases siguiendo el patrón establecido
-- **Plugins modulares**: Compatible con SeleniumPlugin, AllurePlugin, etc.
-- **Variables de entorno**: Utiliza configuración del .env
-- **Estructura de carpetas**: Mantiene la organización original
+## 📄 Licencia
 
-## 📊 Reportes y Monitoreo
+MIT License - ver [LICENSE](LICENSE) para más detalles
 
-- **Allure Reports**: Generación automática integrada
-- **Ejecución con tags**: Filtrado por criticidad, tipo, etc.
-- **Validación continua**: Sanitización de archivos
-- **Feedback detallado**: Mensajes informativos en cada operación
+## 👨‍💻 Autor
 
-## 🚨 Consideraciones
+**Haka Lab** - [Felipe Farías](https://gitlab.com/felipe_farias)
 
-- El MCP asume que existe la estructura base del framework
-- Requiere Python 3.7+ y las dependencias del framework
-- Los archivos generados siguen las convenciones de naming del framework
-- Compatible con ejecución local, hub y saucelabs (según configuración .env)
+## 🔗 Enlaces
 
-## 🤝 Soporte
+- **npm**: https://www.npmjs.com/package/hakalab-mcp
+- **GitLab**: https://gitlab.com/felipe_farias/hakalab-mcp
+- **Issues**: https://gitlab.com/felipe_farias/hakalab-mcp/-/issues
 
-Este MCP está diseñado específicamente para el framework de Haka Lab. Para soporte:
+## 📞 Soporte
 
-1. Verificar que la estructura del framework esté presente
-2. Revisar configuración de variables de entorno (.env)
-3. Validar dependencias instaladas
-4. Consultar logs de ejecución para debugging
+Para reportar bugs o solicitar features, abre un issue en el repositorio de GitLab.
 
 ---
 
-**Desarrollado para Haka Lab Framework de Selenium**  
-*Automatización inteligente de pruebas funcionales*
+**¡Disfruta automatizando con Hakalab-MCP! 🚀**

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * Hakalab-MCP v2.0
@@ -137,7 +137,7 @@ class WebAutomationMCP {
   }
 
   async openPlaywrightBrowser(browser, options) {
-    const { headless = false } = options;
+    const { headless = false } = options; // Por defecto NO headless (visible)
     
     switch (browser.toLowerCase()) {
       case 'chrome':
@@ -1154,9 +1154,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 });
 
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  console.error(`[DEBUG] Received request: ${JSON.stringify(request)}`);
   const { name, arguments: args } = request.params;
 
   try {
+    console.error(`[DEBUG] Executing tool: ${name} with args: ${JSON.stringify(args)}`);
     let result;
 
     switch (name) {
@@ -1166,7 +1168,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           args.engine || 'selenium',
           args.browser || 'chrome',
           {
-            headless: args.headless || false,
+            headless: args.headless || false, // Por defecto NO headless
             windowSize: args.window_size || '1920,1080'
           }
         );
@@ -1395,6 +1397,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
     }
 
+    console.error(`[DEBUG] Tool result: ${JSON.stringify(result)}`);
+
     return {
       content: [
         {
@@ -1407,6 +1411,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     };
 
   } catch (error) {
+    console.error(`[DEBUG] Error in handler: ${error.message}`);
     return {
       content: [
         {
@@ -1420,9 +1425,62 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
 // Iniciar servidor
 async function main() {
+  // Verificar si se está ejecutando como comando CLI
+  if (process.argv.length > 2) {
+    // Modo CLI - ejecutar comando directamente
+    const command = process.argv[2];
+    const args = process.argv.slice(3);
+    
+    console.error(`[CLI] Executing command: ${command} with args: ${args.join(' ')}`);
+    
+    const automation = new WebAutomationMCP();
+    let result;
+    
+    try {
+      switch (command) {
+        case 'open_browser':
+          const browser = args.find(arg => arg.startsWith('--browser='))?.split('=')[1] || 'chrome';
+          const engine = args.find(arg => arg.startsWith('--engine='))?.split('=')[1] || 'selenium';
+          const headless = args.includes('--headless'); // Solo headless si se especifica explícitamente
+          
+          result = await automation.openBrowser(engine, browser, { headless });
+          break;
+          
+        case 'navigate_to_url':
+          const url = args.find(arg => arg.startsWith('--url='))?.split('=')[1];
+          if (!url) {
+            console.log('❌ Error: Missing --url parameter');
+            process.exit(1);
+          }
+          result = await automation.navigateToUrl(url);
+          break;
+          
+        default:
+          console.log(`❌ Error: Unknown command: ${command}`);
+          process.exit(1);
+      }
+      
+      if (result.success) {
+        console.log(`✅ ${result.message || 'Command executed successfully'}`);
+      } else {
+        console.log(`❌ ${result.error || 'Command failed'}`);
+        process.exit(1);
+      }
+    } catch (error) {
+      console.log(`❌ Error: ${error.message}`);
+      process.exit(1);
+    }
+    
+    return;
+  }
+  
+  // Modo servidor MCP
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error('Hakalab-MCP v2.0 server running on stdio');
+  
+  // Mantener el proceso vivo
+  process.stdin.resume();
 }
 
 if (require.main === module) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hakalab-mcp",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Hakalab-MCP - Servidor MCP completo para automatización web con Selenium y Playwright",
   "main": "index.js",
   "bin": {

package/test_simple.js

@@ -0,0 +1,34 @@
+const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const { CallToolRequestSchema } = require('@modelcontextprotocol/sdk/types.js');
+
+const server = new Server(
+  { name: 'test-mcp', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  console.error(`[DEBUG] Received request: ${JSON.stringify(request)}`);
+  
+  return {
+    content: [
+      {
+        type: 'text',
+        text: `✅ Test successful: ${request.params.name}`
+      }
+    ]
+  };
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('Test MCP server running');
+  
+  // Mantener el proceso vivo
+  process.stdin.resume();
+}
+
+if (require.main === module) {
+  main().catch(console.error);
+}

package/README_MCP.md

@@ -1,436 +0,0 @@
-# Hakalab-MCP v2.0
-
-**Servidor MCP completo para automatización web con Selenium y Playwright**
-
-[![npm version](https://img.shields.io/npm/v/hakalab-mcp.svg)](https://www.npmjs.com/package/hakalab-mcp)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## 🚀 Descripción
-
-Hakalab-MCP es un servidor Model Context Protocol (MCP) que proporciona automatización web completa con soporte para **Selenium** y **Playwright**. Incluye 20 herramientas para controlar navegadores, interactuar con elementos, y crear suites de pruebas automatizadas.
-
-## ✨ Características
-
-- ✅ **Doble Motor**: Selenium WebDriver + Playwright
-- ✅ **Múltiples Navegadores**: Chrome, Firefox, Edge, Safari, Chromium, WebKit
-- ✅ **20 Herramientas**: Gestión completa de navegadores e interacciones
-- ✅ **Múltiples Selectores**: CSS, XPath, ID, Name, Class, Tag
-- ✅ **Esperas Inteligentes**: Configurable por herramienta
-- ✅ **Modo Headless**: Para ejecución sin interfaz
-- ✅ **Screenshots**: Capturas automáticas con timestamp
-- ✅ **Framework BDD**: Integración con Behave y Allure
-- ✅ **Súper Liviano**: Solo 11.1 KB
-
-## 📦 Instalación
-
-### Opción 1: Uso Directo con npx (Recomendado)
-
-No requiere instalación previa. Simplemente agrega la configuración a tu cliente MCP:
-
-```json
-{
-  "mcpServers": {
-    "hakalab-mcp": {
-      "command": "npx",
-      "args": ["-y", "hakalab-mcp"]
-    }
-  }
-}
-```
-
-### Opción 2: Instalación Global
-
-```bash
-npm install -g hakalab-mcp
-```
-
-### Opción 3: Instalación Local
-
-```bash
-npm install hakalab-mcp
-```
-
-## 🔧 Configuración
-
-### Para Kiro IDE
-
-Agrega esta configuración a `~/.kiro/settings/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "hakalab-mcp": {
-      "command": "npx",
-      "args": ["-y", "hakalab-mcp"],
-      "disabled": false,
-      "autoApprove": [
-        "open_browser",
-        "close_browser",
-        "navigate_to_url",
-        "click_element",
-        "fill_input",
-        "take_screenshot"
-      ]
-    }
-  }
-}
-```
-
-### Para Claude Desktop
-
-Agrega esta configuración a `~/.claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "hakalab-mcp": {
-      "command": "npx",
-      "args": ["-y", "hakalab-mcp"]
-    }
-  }
-}
-```
-
-### Para Otros Clientes MCP
-
-Usa la configuración estándar:
-
-```json
-{
-  "mcpServers": {
-    "hakalab-mcp": {
-      "command": "npx",
-      "args": ["-y", "hakalab-mcp"]
-    }
-  }
-}
-```
-
-## 🛠️ Herramientas Disponibles
-
-### 🌐 Gestión de Navegadores
-
-#### `open_browser`
-Abre un navegador con el motor especificado.
-
-**Parámetros:**
-- `engine` (string): `selenium` o `playwright` (default: `selenium`)
-- `browser` (string): `chrome`, `firefox`, `edge`, `safari`, `webkit`, `chromium` (default: `chrome`)
-- `headless` (boolean): Ejecutar sin interfaz (default: `false`)
-- `window_size` (string): Tamaño de ventana (default: `1920,1080`)
-
-**Ejemplo:**
-```
-"Abre Chrome con Playwright"
-"Abre Firefox con Selenium en modo headless"
-```
-
-#### `close_browser`
-Cierra el navegador actual.
-
-#### `navigate_to_url`
-Navega a una URL específica.
-
-**Parámetros:**
-- `url` (string): URL a navegar
-
-**Ejemplo:**
-```
-"Ve a https://www.google.com"
-```
-
-#### `go_back`
-Navega hacia atrás en el historial.
-
-#### `go_forward`
-Navega hacia adelante en el historial.
-
-#### `refresh_page`
-Recarga la página actual.
-
-### 🎯 Interacciones Básicas
-
-#### `click_element`
-Hace clic en un elemento.
-
-**Parámetros:**
-- `selector` (string): Selector del elemento
-- `selector_type` (string): `css`, `xpath`, `id`, `name`, `class`, `tag` (default: `css`)
-- `wait_time` (number): Tiempo de espera en ms (default: `5000`)
-
-**Ejemplo:**
-```
-"Haz click en el botón con id 'submit'"
-"Haz click en el elemento con selector '.btn-primary'"
-```
-
-#### `double_click_element`
-Hace doble clic en un elemento.
-
-#### `right_click_element`
-Hace clic derecho en un elemento.
-
-#### `fill_input`
-Completa un campo de texto.
-
-**Parámetros:**
-- `selector` (string): Selector del campo
-- `text` (string): Texto a ingresar
-- `selector_type` (string): Tipo de selector (default: `css`)
-- `clear` (boolean): Limpiar antes de escribir (default: `true`)
-- `wait_time` (number): Tiempo de espera en ms (default: `5000`)
-
-**Ejemplo:**
-```
-"Completa el campo 'username' con 'admin'"
-"Ingresa 'hola' en el campo de búsqueda"
-```
-
-#### `select_option`
-Selecciona una opción en un select/combobox.
-
-**Parámetros:**
-- `selector` (string): Selector del select
-- `value` (string): Valor o texto de la opción
-- `selector_type` (string): Tipo de selector (default: `css`)
-- `by_value` (boolean): Seleccionar por valor (default: `true`)
-- `wait_time` (number): Tiempo de espera en ms (default: `5000`)
-
-**Ejemplo:**
-```
-"Selecciona 'Opción 1' en el combobox"
-```
-
-#### `hover_element`
-Pasa el mouse sobre un elemento.
-
-**Ejemplo:**
-```
-"Pasa el mouse sobre el menú principal"
-```
-
-### 🔧 Interacciones Avanzadas
-
-#### `drag_and_drop`
-Arrastra un elemento y lo suelta en otro.
-
-**Parámetros:**
-- `source_selector` (string): Selector del elemento origen
-- `target_selector` (string): Selector del elemento destino
-- `selector_type` (string): Tipo de selector (default: `css`)
-- `wait_time` (number): Tiempo de espera en ms (default: `5000`)
-
-**Ejemplo:**
-```
-"Arrastra el elemento '.item' al área '.drop-zone'"
-```
-
-#### `scroll_to_element`
-Hace scroll hasta un elemento.
-
-**Parámetros:**
-- `selector` (string): Selector del elemento
-- `selector_type` (string): Tipo de selector (default: `css`)
-- `wait_time` (number): Tiempo de espera en ms (default: `5000`)
-
-**Ejemplo:**
-```
-"Haz scroll hasta el footer"
-```
-
-#### `take_screenshot`
-Toma una captura de pantalla.
-
-**Parámetros:**
-- `filename` (string): Nombre del archivo (opcional)
-
-**Ejemplo:**
-```
-"Toma una captura de pantalla"
-"Haz screenshot como 'resultado.png'"
-```
-
-### 📊 Utilidades
-
-#### `get_current_url`
-Obtiene la URL actual.
-
-#### `get_page_title`
-Obtiene el título de la página.
-
-### 🧪 Framework (Behave + Allure)
-
-#### `create_test_suite`
-Crea una suite completa de pruebas (feature, steps, page object).
-
-**Parámetros:**
-- `feature_name` (string): Nombre del feature
-- `scenarios` (array): Lista de escenarios
-- `page_elements` (array): Elementos para Page Object
-- `tags` (array): Tags del feature
-
-#### `execute_tests`
-Ejecuta pruebas del framework.
-
-**Parámetros:**
-- `tags` (array): Tags para filtrar
-- `feature_file` (string): Archivo específico
-- `parallel` (boolean): Ejecutar en paralelo
-
-#### `list_test_files`
-Lista archivos de prueba.
-
-**Parámetros:**
-- `file_type` (string): `feature`, `steps`, `pages`, `all`
-
-#### `create_page_object`
-Crea un Page Object independiente.
-
-#### `sanitize_tests`
-Valida archivos de prueba.
-
-#### `generate_allure_report`
-Genera reporte de Allure.
-
-## 📝 Ejemplos de Uso
-
-### Ejemplo 1: Búsqueda en Google
-
-```
-1. "Abre Chrome con Playwright"
-2. "Ve a https://www.google.com"
-3. "Completa el campo de búsqueda con 'hola mundo'"
-4. "Haz click en el botón de búsqueda"
-5. "Toma una captura de pantalla"
-6. "Cierra el navegador"
-```
-
-### Ejemplo 2: Automatización de Formulario
-
-```
-1. "Abre Firefox con Selenium"
-2. "Ve a https://example.com/form"
-3. "Completa el campo 'nombre' con 'Juan'"
-4. "Completa el campo 'email' con 'juan@example.com'"
-5. "Selecciona 'Opción 1' en el combobox"
-6. "Haz click en el botón 'Enviar'"
-7. "Toma una captura del resultado"
-```
-
-### Ejemplo 3: Interacciones Complejas
-
-```
-1. "Abre Chrome con Playwright en modo headless"
-2. "Ve a https://example.com"
-3. "Pasa el mouse sobre el menú principal"
-4. "Haz click en 'Productos'"
-5. "Haz scroll hasta el producto deseado"
-6. "Arrastra el producto al carrito"
-7. "Toma una captura"
-```
-
-## 🔄 Flujo de Trabajo Típico
-
-1. **Abrir navegador** → `open_browser`
-2. **Navegar** → `navigate_to_url`
-3. **Interactuar** → `click_element`, `fill_input`, etc.
-4. **Capturar** → `take_screenshot`
-5. **Cerrar** → `close_browser`
-
-## 🎯 Casos de Uso
-
-- ✅ Automatización de pruebas web
-- ✅ Web scraping
-- ✅ Pruebas de regresión
-- ✅ Pruebas de UI
-- ✅ Automatización de tareas repetitivas
-- ✅ Validación de funcionalidad
-- ✅ Pruebas de compatibilidad
-
-## 📋 Requisitos
-
-- **Node.js**: 18.0.0 o superior
-- **npm**: 8.0.0 o superior
-- **Navegadores**: Chrome, Firefox, Edge, Safari (según el motor)
-
-## 🔧 Configuración Avanzada
-
-### Variables de Entorno
-
-```bash
-# Aumentar timeout global
-export MCP_TIMEOUT=30000
-
-# Modo debug
-export DEBUG=hakalab-mcp:*
-```
-
-### Opciones de Ejecución
-
-```json
-{
-  "mcpServers": {
-    "hakalab-mcp": {
-      "command": "npx",
-      "args": ["-y", "hakalab-mcp"],
-      "env": {
-        "NODE_ENV": "production",
-        "DEBUG": "false"
-      }
-    }
-  }
-}
-```
-
-## 🐛 Solución de Problemas
-
-### Error: "Browser not found"
-- Asegúrate de tener el navegador instalado
-- Para Playwright: ejecuta `npx playwright install`
-
-### Error: "Timeout waiting for element"
-- Aumenta el `wait_time` en los parámetros
-- Verifica que el selector sea correcto
-
-### Error: "Connection refused"
-- Verifica que el MCP esté correctamente configurado
-- Reinicia tu cliente MCP
-
-## 📚 Documentación Adicional
-
-- [Model Context Protocol](https://modelcontextprotocol.io/)
-- [Selenium WebDriver](https://www.selenium.dev/)
-- [Playwright](https://playwright.dev/)
-- [Behave BDD](https://behave.readthedocs.io/)
-
-## 🤝 Contribuciones
-
-Las contribuciones son bienvenidas. Por favor:
-
-1. Fork el repositorio
-2. Crea una rama para tu feature
-3. Commit tus cambios
-4. Push a la rama
-5. Abre un Pull Request
-
-## 📄 Licencia
-
-MIT License - ver [LICENSE](LICENSE) para más detalles
-
-## 👨‍💻 Autor
-
-**Haka Lab** - [Felipe Farías](https://gitlab.com/felipe_farias)
-
-## 🔗 Enlaces
-
-- **npm**: https://www.npmjs.com/package/hakalab-mcp
-- **GitLab**: https://gitlab.com/felipe_farias/hakalab-mcp
-- **Issues**: https://gitlab.com/felipe_farias/hakalab-mcp/-/issues
-
-## 📞 Soporte
-
-Para reportar bugs o solicitar features, abre un issue en el repositorio de GitLab.
-
----
-
-**¡Disfruta automatizando con Hakalab-MCP! 🚀**