Getting Started¶

Complete guide to configure and use the AI Agent + Lippia MCP Server architecture.

Follow these steps to deploy the MCP Server and start automating with artificial intelligence.

Prerequisites¶

Option 1: Development (Local)¶

Java Development Kit¶

Version: Java 17 or higher
Verify: java --version

Apache Maven¶

Version: Maven 3.8+ recommended
Verify: mvn --version

Web Browsers¶

Supported: Chrome, Firefox
WebDrivers: Downloaded automatically

Option 2: Docker¶

Docker¶

Verify: docker version
Requirement: Docker Engine installed and running

Installation¶

Choose your preferred installation method:

Development (Local)Docker

Step 1: Clone the Repository¶

WindowsmacOSLinux

Open PowerShell as Administrator and clone the Lippia MCP Server project.

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

Expected result

Project cloned successfully and you're now in the project directory.

Open Terminal and clone the Lippia MCP Server project.

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

Open Terminal and clone the Lippia MCP Server project.

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

Expected result

Project cloned successfully and you're now in the project directory.

Step 2: Compile the Project¶

WindowsmacOSLinux

Use Maven to compile and package the Lippia MCP server.

mvn clean package

Use Maven to compile and package the Lippia MCP server.

mvn clean package

Use Maven to compile and package the Lippia MCP server.

mvn clean package

Expected result

The file target/mcp-server-1.0-SNAPSHOT.jar is generated

Step 3: Install Cursor via CLI¶

WindowsmacOSLinux

Install Cursor AI Editor using Windows Package Manager (winget).

winget install Cursor

Alternative

If winget is not available, download from cursor.sh

Install Cursor AI Editor using Homebrew.

# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Cursor
brew install --cask cursor

Alternative

If you prefer, you can download from cursor.sh

Install Cursor AI Editor using your preferred package manager.

Option 1: Ubuntu/Debian (APT)¶

# Download and install 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

Option 2: Snap Package (Universal)¶

sudo snap install cursor --classic

Option 3: AppImage (Portable)¶

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

Alternative

You can also download from cursor.sh

Verify installation

Type cursor --version in your terminal

Step 4: Configure MCP Servers in Cursor¶

WindowsmacOSLinux

Open Cursor settings and configure the MCP servers in the configuration JSON.

Location

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

Steps to configure:

Open Cursor
Press Ctrl+Shift+P and search for "Preferences: Open Settings (JSON)"
Add the following MCP servers configuration:

{
    "mcpServers": {
        "lippia": {
            "command": "java",
            "args": ["-jar", "C:\\path\\to\\your\\project\\target\\mcp-server-1.0-SNAPSHOT.jar"]
        }
    }
}

Important

Replace C:\\path\\to\\your\\project with your actual project path using double backslashes.

Open Cursor settings and configure the MCP servers in the configuration JSON.

Location

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

Steps to configure:

Open Cursor
Press ⌘+Shift+P and search for "Preferences: Open Settings (JSON)"
Add the following MCP servers configuration:

{
    "mcpServers": {
        "lippia": {
            "command": "java",
            "args": ["-jar", "/Users/your-username/path/to/project/target/mcp-server-1.0-SNAPSHOT.jar"]
        }
    }
}

Important

Replace /Users/your-username/path/to/project with your actual project path.

Open Cursor settings and configure the MCP servers in the configuration JSON.

Location

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

Steps to configure:

Open Cursor
Press Ctrl+Shift+P and search for "Preferences: Open Settings (JSON)"
Add the following MCP servers configuration:

{
    "mcpServers": {
        "lippia": {
            "command": "java",
            "args": ["-jar", "/home/your-username/path/to/project/target/mcp-server-1.0-SNAPSHOT.jar"]
        }
    }
}

Important

Replace /home/your-username/path/to/project with your actual project path.

Step 1: Create Docker Network¶

Create a Docker network for container communication:

docker create network mcp

Expected result

Network mcp created successfully.

Step 2: Run Selenium Hub¶

Run the Selenium Hub container:

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

Expected result

Selenium Hub running at http://localhost:4444

Step 3: Install Cursor¶

WindowsmacOSLinux

Install Cursor AI Editor using Windows Package Manager (winget).

winget install Cursor

Alternative

If winget is not available, download from cursor.sh

Install Cursor AI Editor using Homebrew.

# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Cursor
brew install --cask cursor

Alternative

If you prefer, you can download from cursor.sh

Install Cursor AI Editor using your preferred package manager.

Option 1: Ubuntu/Debian (APT)¶

# Download and install 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

Option 2: Snap Package (Universal)¶

sudo snap install cursor --classic

Option 3: AppImage (Portable)¶

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

Alternative

You can also download from cursor.sh

Verify installation

Type cursor --version in your terminal

Step 4: Configure MCP Servers in Cursor (Docker)¶

WindowsmacOSLinux

Open Cursor settings and configure the MCP servers in the configuration JSON.

Location

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

Steps to configure:

Open Cursor
Press Ctrl+Shift+P and search for "Preferences: Open Settings (JSON)"
Add the following MCP servers configuration:

{
    "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"
            ]
        }
    }
}

Open Cursor settings and configure the MCP servers in the configuration JSON.

Location

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

Steps to configure:

Open Cursor
Press ⌘+Shift+P and search for "Preferences: Open Settings (JSON)"
Add the following MCP servers configuration:

{
    "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"
            ]
        }
    }
}

Open Cursor settings and configure the MCP servers in the configuration JSON.

Location

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

Steps to configure:

Open Cursor
Press Ctrl+Shift+P and search for "Preferences: Open Settings (JSON)"
Add the following MCP servers configuration:

{
    "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"
            ]
        }
    }
}

Step 5: Verify Connectivity¶

Restart Cursor and test that Lippia MCP Server is working correctly.

Lippia MCP Server Tools¶

Building & Reporting¶

mcp_lippia_create_feature
mcp_lippia_create_test
mcp_lippia_execute_test
mcp_lippia_send_report

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

Waits¶

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

Verifications¶

mcp_lippia_is_enabled
mcp_lippia_is_selected
mcp_lippia_is_present
mcp_lippia_is_visible

Test

In Cursor chat, type: "Show me available MCP tools" to verify server are connected.

Usage Example¶

Complete Autonomous Flow¶

Prompt:

Hello, please follow these steps:

1. Read and understand the proposed User Story

User Story: Successful Product Purchase on SauceDemo
Title: As a logged-in user, I want to be able to successfully purchase a product to complete my order and receive it.

Acceptance Criteria:

- The user must be able to log in with valid credentials.
- The user must be able to add at least one product to the cart from the store.
- The user must be able to access the cart and verify the selected products.
- The user must be able to proceed to checkout and enter personal information (name, surname, postal code).
- The user must be able to continue to the order summary and confirm the purchase.
- Upon completion, the system must display a successful purchase confirmation message: "THANK YOU FOR YOUR ORDER".

Test Scenario (Happy Path):

- Navigate to https://www.saucedemo.com.
- Log in as standard_user / secret_sauce.
- Add the "Sauce Labs Backpack" product to the cart.
- Go to the cart and click on Checkout.

Complete the personal information:

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

- Click on Continue and then on Finish.
- Verify the purchase confirmation message.

2. You must navigate autonomously through the application to map the flow and actions with Lippia.

Technical detail:
For each new screen during autonomous navigation, you must call the "get_page_source" tool to know exactly which locator you need in order to perform the corresponding actions.

3. Generate the feature files based on the User Story, leveraging the navigation performed previously.
4. Create the tests in Java with Lippia MCP.
5. Execute the tests in Java with Lippia MCP.

The AI Agent coordinates the entire flow using Lippia MCP Server for navigation and testing.

Getting Started¶

Prerequisites¶

Option 1: Development (Local)¶

Java Development Kit¶

Apache Maven¶

Web Browsers¶

Option 2: Docker¶

Docker¶

Installation¶

Step 1: Clone the Repository¶

Step 2: Compile the Project¶

Step 3: Install Cursor via CLI¶

Option 1: Ubuntu/Debian (APT)¶

Option 2: Snap Package (Universal)¶

Option 3: AppImage (Portable)¶

Step 4: Configure MCP Servers in Cursor¶

Step 1: Create Docker Network¶

Step 2: Run Selenium Hub¶

Step 3: Install Cursor¶

Option 1: Ubuntu/Debian (APT)¶

Option 2: Snap Package (Universal)¶

Option 3: AppImage (Portable)¶

Step 4: Configure MCP Servers in Cursor (Docker)¶

Step 5: Verify Connectivity¶

Lippia MCP Server Tools¶

Building & Reporting¶

Navigation & Actions¶

Waits¶

Verifications¶

Usage Example¶

Complete Autonomous Flow¶