Which integrations are available for this server?

Automatically commits and pushes test run results to a GitHub repository.

How do I use MCP Test Automation Framework?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

MCP Test Automation Framework

by rabbiyamehmood

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

🤖 MCP Test Automation Framework

SQA Test Automation powered by Claude/Deepseek AI with self-healing locators and auto GitHub checkin

🏗️ Architecture

mcp-automation/
├── src/
│   ├── mcp/                  # MCP Server (connects AI to browser)
│   │   ├── mcp-server.ts     # MCP tool definitions & handlers
│   │   └── index.ts
│   ├── core/                 # Core modules
│   │   ├── browser-manager.ts  # Playwright browser lifecycle
│   │   ├── config.ts           # Settings loader
│   │   └── logger.ts           # Logging utility
│   ├── healing/              # Self-Healing Engine
│   │   └── locator-healer.ts   # Alternative locator strategies
│   ├── scripts/              # Utility scripts
│   │   └── git-auto-checkin.ts # Auto commit & push to GitHub
│   ├── tests/                # Test definitions
│   │   ├── types.ts
│   │   └── google-search.ts
│   ├── mcp-server-entry.ts   # MCP server entry point
│   └── runner.ts             # Direct test runner
├── config/
│   └── settings.json         # Framework configuration
├── logs/                     # Run logs & screenshots
├── .github/workflows/        # CI/CD pipeline
├── package.json
├── tsconfig.json
└── README.md

Related MCP server: BarrHawk

🔄 How It Works

  1. AI (Claude/Deepseek) calls MCP tool
          │
          ▼
  2. Playwright executes browser action
          │
          ▼
  3. Element not found? 
          │
          ▼
  4. Self-Healing Engine kicks in
     ┌─────────────────────────────┐
     │ Tries: role → text →        │
     │ placeholder → label → testId│
     │ → CSS → XPath → aria-label  │
     └─────────────────────────────┘
          │
          ▼
  5. Found? → Logs healing action, proceeds
     Not found? → Screenshot, reports failure
          │
          ▼
  6. GitHub Auto Checkin
     ┌─────────────────────────────┐
     │ Creates branch              │
     │ test-run/<name>-<timestamp> │
     │ Stages & commits all files  │
     │ Pushes to remote            │
     └─────────────────────────────┘

🚀 Quick Start

1. Install dependencies

npm install
npx playwright install chromium

2. Configure

Edit config/settings.json:

Set AI provider and API keys (via env vars)
Configure browser options
Set GitHub remote URL

3. Set API Keys (optional — for AI features)

set ANTHROPIC_API_KEY=sk-ant-...    # For Claude
set DEEPSEEK_API_KEY=sk-...         # For Deepseek

4. Run tests directly

npm run dev

5. Start MCP Server (for AI assistant connection)

npm run mcp-server

Then connect your AI assistant (Claude/Deepseek) to this MCP server.

🛠️ MCP Tools Available to AI

Tool	Description
`navigate`	Navigate to a URL
`click`	Click an element (with self-healing)
`type` / `fill`	Type text into fields (with self-healing)
`get_text`	Get element text (with self-healing)
`wait_for_selector`	Wait for element to appear
`screenshot`	Capture page screenshot
`press_key`	Press keyboard keys
`run_test`	Execute a full test case
`auto_checkin`	Commit & push to GitHub
`get_healing_summary`	View self-healing stats

🧪 Self-Healing

When a locator fails, the engine tries these strategies in order:

getByRole — Find by ARIA role
getByText — Find by text content
getByPlaceholder — Find by placeholder attribute
getByLabel — Find by associated label
getByTestId — Find by data-testid
CSS selector — Try original selector as CSS
CSS alternatives — e.g., textarea → input, attribute variations
[aria-label] — Find by aria-label attribute

All healing actions are logged to logs/healing-log.json.

📤 GitHub Auto Checkin

After each test run, the framework automatically:

Creates a new branch: test-run/<test-name>-<timestamp>
Stages all changed files (tests, logs, screenshots)
Commits with descriptive message
Pushes to remote

🔧 Configuration

See config/settings.json for all options:

Section	Key	Description
`ai`	`provider`	`"auto"`, `"claude"`, or `"deepseek"`
`browser`	`headless`	`true`/`false` for headed mode
`selfHealing`	`enabled`	Enable/disable self-healing
`selfHealing`	`maxRetries`	Max healing attempts per locator
`github`	`autoCheckin`	Enable auto commit/push
`logging`	`level`	`"debug"`, `"info"`, `"warn"`, `"error"`

📄 License

MIT

This server cannot be deployed

Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

Testmode AI
digital.amber
Write, run and check natural-language browser tests of your web app from your AI assistant.
Testing & QA Tools Browser Automation Developer Tools
1
https://api.testmode.ai/mcp
AIVA
works.aiva
No-code, AI-assisted UI testing: record new tests, run existing ones, and monitor the results.
Testing & QA Tools Browser Automation AI & Machine Learning
1
https://api.aiva.works/mcp
Qlane
ai.qlane
AI QA that runs your app in a browser on every pull request: projects, test targets, test cases.
Testing & QA Tools CI/CD & DevOps Browser Automation
1
https://mcp-us.qlane.ai/api/mcp
aiqaramba
io.github.ajrogier
Browser-based QA for AI-built software. Test pages with real browsers via agents.
Testing & QA Tools Browser Automation Agent Orchestration
2
https://mcp.aiqaramba.com/mcp

Related MCP Servers

LocatorLabs MCP Server
Testing & QA Tools Browser Automation Developer Tools
naveenanimation20
A
license
A
quality
D
maintenance
Generates intelligent Playwright locators with reliability rankings, creates Page Object Models, and runs test automation scripts directly from your IDE or AI assistant.
Updated 3 months ago (2026-08-04 08:12 UTC)
5
9 npm
1
MIT
BarrHawkofficial
Testing & QA Tools Browser Automation
barrhawk
A
license
Not graded
quality
D
maintenance
Enables automated end-to-end testing and verification of web applications through natural language, with self-healing selectors and dual-mode execution.
Updated 3 months ago (2026-08-08 08:32 UTC)
15
MIT
self-healing-browser-mcp
Browser Automation Agent Orchestration
RAJUSHANIGARAPU
A
license
B
quality
B
maintenance
Enables AI agents to control a browser with self-healing locators that automatically recover when selectors change, allowing reliable web automation through natural language.
Updated a month ago (2026-10-03 10:18 UTC)
7
MIT
tuxedo-qa
jonathan-ponciano
A
license
A
quality
B
maintenance
Enables AI assistants to create, run, autocorrect, and monitor Playwright tests for your app with a local dashboard, credential vault, and public status page.
Updated 3 months ago (2026-07-24 12:25 UTC)
16
MIT