Comenzando¶

Guía completa para configurar y usar la arquitectura de Agente de IA + Servidor MCP.

Sigue estos pasos para desplegar el servidor MCP y comenzar a automatizar con inteligencia artificial.

Prerrequisitos¶

Opción 1: Development (Local)¶

Java Development Kit¶

Versión: Java 17 o superior
Verificar: java --version

Apache Maven¶

Versión: Maven 3.8+ recomendado
Verificar: mvn --version

Navegadores Web¶

Soportados: Chrome, Firefox
WebDrivers: Descargados automáticamente

Opción 2: Docker¶

Docker¶

Verificar: docker version
Requisito: Docker Engine instalado y funcionando

Instalación¶

Elige tu método de instalación preferido:

Development (Local)Docker

Paso 1: Clonar el Repositorio¶

WindowsmacOSLinux

Abre PowerShell como Administrador y clona el proyecto Lippia MCP Server.

git clone https://github.com/Lippia-io/Lippia-MCP-Server.git && cd "$(basename "$_" .git)"

Resultado esperado

Proyecto clonado exitosamente y ahora estás en el directorio del proyecto.

Abre Terminal y clona el proyecto Lippia MCP Server.

git clone https://github.com/Lippia-io/Lippia-MCP-Server.git && cd "$(basename "$_" .git)"

Abre Terminal y clona el proyecto Lippia MCP Server.

git clone https://github.com/Lippia-io/Lippia-MCP-Server.git && cd "$(basename "$_" .git)"

Resultado esperado

Proyecto clonado exitosamente y ahora estás en el directorio del proyecto.

Paso 2: Compilar el Proyecto¶

WindowsmacOSLinux

Usa Maven para compilar y empaquetar el servidor Lippia MCP.

mvn clean package

Usa Maven para compilar y empaquetar el servidor Lippia MCP.

mvn clean package

Usa Maven para compilar y empaquetar el servidor Lippia MCP.

mvn clean package

Resultado esperado

Se genera el archivo target/mcp-server-1.0-SNAPSHOT.jar

Paso 3: Instalar Cursor vía CLI¶

WindowsmacOSLinux

Instala Cursor AI Editor usando Windows Package Manager (winget).

winget install Cursor

Alternativa

Si winget no está disponible, descarga desde cursor.sh

Instala Cursor AI Editor usando Homebrew.

# Instala Homebrew si no lo tienes
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instala Cursor
brew install --cask cursor

Alternativa

Si prefieres, puedes descargar desde cursor.sh

Instala Cursor AI Editor usando tu gestor de paquetes preferido.

Opción 1: Ubuntu/Debian (APT)¶

# Descargar e instalar Cursor
wget -qO- https://download.todesktop.com/200823hxqfhhbr/linux | sudo apt-key add -
echo "deb [arch=amd64] https://download.todesktop.com/200823hxqfhhbr/linux/ stable main" | sudo tee /etc/apt/sources.list.d/cursor.list
sudo apt update && sudo apt install cursor

Opción 2: Paquete Snap (Universal)¶

sudo snap install cursor --classic

Opción 3: AppImage (Portable)¶

# Descargar AppImage desde cursor.sh
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage
chmod +x cursor.AppImage
./cursor.AppImage

Alternativa

También puedes descargar desde cursor.sh

Verificar instalación

Escribe cursor --version en tu terminal

Paso 4: Configurar Servidores MCP en Cursor¶

WindowsmacOSLinux

Abre la configuración de Cursor y configura los servidores MCP en el JSON de configuración.

Ubicación

%APPDATA%\Cursor\User\globalStorage\cursor.settings\settings.json

Pasos para configurar:

Abre Cursor
Presiona Ctrl+Shift+P y busca "Preferences: Open Settings (JSON)"
Agrega la siguiente configuración de servidores MCP:

{
    "mcpServers": {
        "lippia": {
            "command": "java",
            "args": ["-jar", "C:\\ruta\\a\\tu\\proyecto\\target\\mcp-server-1.0-SNAPSHOT.jar"]
        }
    }
}

Importante

Reemplaza C:\\ruta\\a\\tu\\proyecto con tu ruta real del proyecto usando dobles barras invertidas.

Abre la configuración de Cursor y configura los servidores MCP en el JSON de configuración.

Ubicación

~/Library/Application Support/Cursor/User/globalStorage/cursor.settings/settings.json

Pasos para configurar:

Abre Cursor
Presiona ⌘+Shift+P y busca "Preferences: Open Settings (JSON)"
Agrega la siguiente configuración de servidores MCP:

{
    "mcpServers": {
        "lippia": {
            "command": "java",
            "args": ["-jar", "/Users/tu-usuario/ruta/al/proyecto/target/mcp-server-1.0-SNAPSHOT.jar"]
        }
    }
}

Importante

Reemplaza /Users/tu-usuario/ruta/al/proyecto con tu ruta real del proyecto.

Abre la configuración de Cursor y configura los servidores MCP en el JSON de configuración.

Ubicación

~/.config/Cursor/User/globalStorage/cursor.settings/settings.json

Pasos para configurar:

Abre Cursor
Presiona Ctrl+Shift+P y busca "Preferences: Open Settings (JSON)"
Agrega la siguiente configuración de servidores MCP:

{
    "mcpServers": {
        "lippia": {
            "command": "java",
            "args": ["-jar", "/home/tu-usuario/ruta/al/proyecto/target/mcp-server-1.0-SNAPSHOT.jar"]
        }
    }
}

Importante

Reemplaza /home/tu-usuario/ruta/al/proyecto con tu ruta real del proyecto.

Paso 1: Crear Red Docker¶

Crea una red Docker para la comunicación entre contenedores:

docker create network mcp

Resultado esperado

Red mcp creada exitosamente.

Paso 2: Ejecutar Selenium Hub¶

Ejecuta el contenedor de Selenium Hub:

docker run -i --rm --init --pull=always --name selenium-hub --network mcp -p 4444:4444 -p 7900:7900 --shm-size=2g selenium/standalone-chromium:latest

Resultado esperado

Selenium Hub ejecutándose en http://localhost:4444

Paso 3: Instalar Cursor¶

WindowsmacOSLinux

Instala Cursor AI Editor usando Windows Package Manager (winget).

winget install Cursor

Alternativa

Si winget no está disponible, descarga desde cursor.sh

Instala Cursor AI Editor usando Homebrew.

# Instala Homebrew si no lo tienes
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instala Cursor
brew install --cask cursor

Alternativa

Si prefieres, puedes descargar desde cursor.sh

Instala Cursor AI Editor usando tu gestor de paquetes preferido.

Opción 1: Ubuntu/Debian (APT)¶

# Descargar e instalar Cursor
wget -qO- https://download.todesktop.com/200823hxqfhhbr/linux | sudo apt-key add -
echo "deb [arch=amd64] https://download.todesktop.com/200823hxqfhhbr/linux/ stable main" | sudo tee /etc/apt/sources.list.d/cursor.list
sudo apt update && sudo apt install cursor

Opción 2: Paquete Snap (Universal)¶

sudo snap install cursor --classic

Opción 3: AppImage (Portable)¶

# Descargar AppImage desde cursor.sh
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage
chmod +x cursor.AppImage
./cursor.AppImage

Alternativa

También puedes descargar desde cursor.sh

Verificar instalación

Escribe cursor --version en tu terminal

Paso 4: Configurar Servidores MCP en Cursor (Docker)¶

WindowsmacOSLinux

Abre la configuración de Cursor y configura los servidores MCP en el JSON de configuración.

Ubicación

%APPDATA%\Cursor\User\globalStorage\cursor.settings\settings.json

Pasos para configurar:

Abre Cursor
Presiona Ctrl+Shift+P y busca "Preferences: Open Settings (JSON)"
Agrega la siguiente configuración de servidores MCP:

{
    "mcpServers": {
        "lippia": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm", "--init", "--pull=always",
                "--network", "mcp",
                "--name", "lippia-mcp-server",
                "-e", "DRIVER_HUB_URL=http://selenium-hub:4444/wd/hub",
                "-e", "WEBHOOK_URL_DISCORD=${WEBHOOK_URL_DISCORD}", // optional
                "-e", "WEBHOOK_URL_GOOGLE=${WEBHOOK_URL_GOOGLE}", // optional
                "-e", "WEBHOOK_URL_TEAMS=${WEBHOOK_URL_TEAMS}", // optional
                "-e", "WEBHOOK_URL_SLACK=${WEBHOOK_URL_SLACK}", // optional
                "crowdar/lippia-mcp-server:latest"
            ]
        }
    }
}

Abre la configuración de Cursor y configura los servidores MCP en el JSON de configuración.

Ubicación

~/Library/Application Support/Cursor/User/globalStorage/cursor.settings/settings.json

Pasos para configurar:

Abre Cursor
Presiona ⌘+Shift+P y busca "Preferences: Open Settings (JSON)"
Agrega la siguiente configuración de servidores MCP:

{
    "mcpServers": {
        "lippia": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm", "--init", "--pull=always",
                "--network", "mcp",
                "--name", "lippia-mcp-server",
                "-e", "DRIVER_HUB_URL=http://selenium-hub:4444/wd/hub",
                "-e", "WEBHOOK_URL_DISCORD=${WEBHOOK_URL_DISCORD}", // optional
                "-e", "WEBHOOK_URL_GOOGLE=${WEBHOOK_URL_GOOGLE}", // optional
                "-e", "WEBHOOK_URL_TEAMS=${WEBHOOK_URL_TEAMS}", // optional
                "-e", "WEBHOOK_URL_SLACK=${WEBHOOK_URL_SLACK}", // optional
                "crowdar/lippia-mcp-server:latest"
            ]
        }
    }
}

Abre la configuración de Cursor y configura los servidores MCP en el JSON de configuración.

Ubicación

~/.config/Cursor/User/globalStorage/cursor.settings/settings.json

Pasos para configurar:

Abre Cursor
Presiona Ctrl+Shift+P y busca "Preferences: Open Settings (JSON)"
Agrega la siguiente configuración de servidores MCP:

{
    "mcpServers": {
        "lippia": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm", "--init", "--pull=always",
                "--network", "mcp",
                "--name", "lippia-mcp-server",
                "-e", "DRIVER_HUB_URL=http://selenium-hub:4444/wd/hub",
                "-e", "WEBHOOK_URL_DISCORD=${WEBHOOK_URL_DISCORD}", // optional
                "-e", "WEBHOOK_URL_GOOGLE=${WEBHOOK_URL_GOOGLE}", // optional
                "-e", "WEBHOOK_URL_TEAMS=${WEBHOOK_URL_TEAMS}", // optional
                "-e", "WEBHOOK_URL_SLACK=${WEBHOOK_URL_SLACK}", // optional
                "crowdar/lippia-mcp-server:latest"
            ]
        }
    }
}

Paso 5: Verificar Conectividad¶

Reinicia Cursor y prueba que el Lippia MCP Server esté funcionando correctamente.

Herramientas del Lippia MCP Server¶

Construcción y Reportes¶

mcp_lippia_create_feature
mcp_lippia_create_test
mcp_lippia_execute_test
mcp_lippia_send_report

Navegación y Acciones¶

mcp_lippia_open_browser
mcp_lippia_close_browser
mcp_lippia_navigate_to
mcp_lippia_click
mcp_lippia_type
mcp_lippia_get_text
mcp_lippia_get_page_title
mcp_lippia_get_page_source
mcp_lippia_get_current_url
mcp_lippia_screenshot

Esperas¶

mcp_lippia_wait_clickable
mcp_lippia_wait_visibility
mcp_lippia_wait_visibilities
mcp_lippia_wait_invisibility
mcp_lippia_wait_invisibilities
mcp_lippia_wait_presence
mcp_lippia_wait_presences

Verificaciones¶

mcp_lippia_is_enabled
mcp_lippia_is_selected
mcp_lippia_is_present
mcp_lippia_is_visible

Prueba

En el chat de Cursor, escribe: "Show me available MCP tools" para verificar que el servidor esté conectado.

Ejemplo de Uso¶

Flujo Autónomo Completo¶

Prompt:

Hola, por favor sigue estos pasos:

1. Lee y entiende la Historia de Usuario propuesta

Historia de Usuario: Compra Exitosa de Producto en SauceDemo
Título: Como usuario logueado, quiero poder comprar exitosamente un producto para completar mi pedido y recibirlo.

Criterios de Aceptación:

- El usuario debe poder loguearse con credenciales válidas.
- El usuario debe poder agregar al menos un producto al carrito desde la tienda.
- El usuario debe poder acceder al carrito y verificar los productos seleccionados.
- El usuario debe poder proceder al checkout e ingresar información personal (nombre, apellido, código postal).
- El usuario debe poder continuar al resumen del pedido y confirmar la compra.
- Al completarse, el sistema debe mostrar un mensaje de confirmación de compra exitosa: "THANK YOU FOR YOUR ORDER".

Escenario de Prueba (Happy Path):

- Navegar a https://www.saucedemo.com.
- Loguearse como standard_user / secret_sauce.
- Agregar el producto "Sauce Labs Backpack" al carrito.
- Ir al carrito y hacer clic en Checkout.

Completar la información personal:

- First Name: John
- Last Name: Doe
- Zip Code: 12345

- Hacer clic en Continue y luego en Finish.
- Verificar el mensaje de confirmación de compra.

2. Debes navegar autónomamente a través de la aplicación para mapear el flujo y acciones con Lippia.

Detalle técnico:
Por cada pantalla nueva durante la navegación autónoma, debes llamar a la tool "get_page_source" para saber exactamente cuál es el localizador que requieres para ejecutar las acciones correspondientes.

3. Generar los archivos de características basados en la Historia de Usuario, aprovechando la navegación realizada previamente.
4. Crear las pruebas en Java con Lippia MCP.
5. Ejecutar las pruebas en Java con Lippia MCP.

El Agente de IA coordina todo el flujo usando Lippia MCP Server para navegación y testing.