Add Selenium Self-Healing MCP Server

[aiqualitylab]

---

name: Add a new MCP server
about: Requests for adding a new MCP server to the Docker Catalog
title: "Add Selenium Self-Healing MCP Server"
labels: submission
assignees: ""

MCP Server Information

Server Name: selenium-selfhealing-mcp
Repository URL: https://github.com/aiqualitylab/selenium-selfhealing-mcp
Brief Description: Automatically fixes broken Selenium test locators using intelligent fallback strategies (CSS → text search → visible elements). Designed for AI assistant integration to reduce test maintenance overhead.

Basic Requirements

• Open Source: Uses acceptable license (MIT License)
• MCP Compliant: Implements MCP API specification (mcp.server, list_tools, call_tool)
• Active Development: Recent commits and maintained
• Docker Artifact: Dockerfile included (Chrome 143 + ChromeDriver 143 + Python 3.11)
• Documentation: README with installation, usage, API docs, troubleshooting
• Security Contact: GitHub Issues enabled at repository

Submitter Checklist

• This server meets the basic requirements listed above
• I understand this will undergo automated and manual review
• I have tested the MCP Server using task validate -- --name selenium-selfhealing-mcp (manual validation completed)
• I have built the MCP Server using task build -- --tools selenium-selfhealing-mcp (Docker build successful locally)
• If the server requires credentials to test it, I have shared test credentials using this form (N/A - no credentials required)

Additional Information

Testing Performed

• Python execution: Verified
• Claude Desktop integration: Tested on Windows
• Docker build: Successful (Chrome + ChromeDriver v143)
• Self-healing functionality: Confirmed on example.com
• All 4 tools operational: open, click, type, screenshot

Key Features

• Smart fallback: Original CSS → Text matching → Visible element discovery
• Returns new working locators for test updates
• Comprehensive error handling and logging (INFO/ERROR/DEBUG)
• Container isolated with Chrome security flags
• Zero configuration required

Use Cases

• Automated test maintenance when UI changes
• AI-powered exploratory testing
• Test migration and modernization
• CI/CD pipeline resilience

Compliance

• Security best practices (Docker isolation, no credential storage)
• Working Docker deployment
• MCP standards compatible
• Error handling and logging

Author

aiqualitylab