MCP Test Runner

Install via pip for persistent use, or use uvx for a zero-install approach. For playwright support, also install Playwright browsers.

pip install mk-qa-master
# For Playwright:
playwright install chromium

The built-in doctor command checks that required framework dependencies are available.

mk-qa-master doctor

Add mk-qa-master to your MCP client config. Set QA_RUNNER to your framework (pytest, jest, cypress, go, maestro, schemathesis, newman, or edge) and QA_PROJECT_ROOT to the absolute path of your test project.

{
  "mcpServers": {
    "mk-qa-master": {
      "command": "uvx",
      "args": ["mk-qa-master"],
      "env": {
        "QA_RUNNER": "pytest",
        "QA_PROJECT_ROOT": "/absolute/path/to/your-project"
      }
    }
  }
}

Restart Claude Desktop or your MCP client so it picks up the new server and environment variables.

Ask your AI assistant to run your test suite. The server will execute the tests, capture screenshots and traces on failure, and return structured results.

Use the analyze_url or analyze_screen tools to inspect a page or mobile screen, then ask the assistant to generate new tests with concrete selectors based on the live DOM or view hierarchy.