Healenium MCP Server

A Spring Boot-based Model Context Protocol (MCP) server that provides web automation capabilities using Healenium's self-healing Selenium framework.

Overview

This project integrates Healenium with MCP to provide AI agents with robust web automation capabilities. Healenium adds self-healing functionality to Selenium WebDriver, automatically fixing broken locators when web elements change.

Features

• Self-Healing Web Automation: Automatically adapts to UI changes using Healenium
• MCP Integration: Exposes web automation tools through Model Context Protocol
• Spring Boot Architecture: Built on Spring Boot 3.5.7 with Spring AI MCP support
• WebDriver Support: Uses Selenium WebDriver interface for web automation

Available Tools

startBrowser

• Description: Starts a new browser session
• Parameters:
  • browser (String): Browser type - "chrome", "edge", "firefox" (defaults to Chrome if invalid)
• Usage: Initializes a new WebDriver browser instance with Healenium self-healing capabilities

navigateTo

• Description: Navigate to a specific URL
• Parameters:
  • url (String): The URL to navigate to
• Usage: Opens the specified URL in the current browser session

findElement

• Description: Find a single web element using various locator strategies
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
• Usage: Locates and verifies the presence of a web element, returns "Element Found" if successful

findElements

• Description: Find multiple web elements using various locator strategies
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
• Usage: Locates multiple elements matching the criteria, returns "All Elements Found" if successful

clickElement

• Description: Click on a single web element
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
• Usage: Waits for element to be clickable and performs click action, returns "Element Clicked" if successful

clickElements

• Description: Click on multiple web elements
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
• Usage: Finds all matching elements and clicks each one, returns "All Elements Clicked" if successful

hoverOverElement

• Description: Hover the mouse pointer over a single web element
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
• Usage: Moves the mouse cursor to the specified element, useful for triggering hover effects and dropdown menus, returns "Successfully Hovered" if successful

hoverOverAll

• Description: Hover the mouse pointer over multiple web elements sequentially
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
• Usage: Sequentially moves the mouse cursor over all matching elements, returns "Successfully Hovered Over All" if successful

sendKeysToElement

• Description: Send keyboard input (text) to a web element
• Parameters:
  • type (String): Locator type - "id", "classname", "tagname", "name", "link text", "partial link text", "css selector", "xpath"
  • value (String): The locator value
  • keys (String): The text/keys to send to the elem

... View full README on GitHub