whatisgithub

What is mk-qa-master?

kao273183/mk-qa-master — explained in plain English

Analysis updated 2026-05-18

20PythonAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

An MCP server that lets AI assistants run, analyze, and improve your test suite across pytest, Jest, Cypress, Go, and mobile testing.

Mindmap

mindmap
  root((repo))
    What it does
      Universal MCP test runner
      Multi framework support
      Self improvement coach
    Tech stack
      Python
      MCP
      Playwright
      Maestro
    Use cases
      Run tests via AI assistant
      Generate tests from analysis
      Track flaky tests
    Audience
      QA engineers
      Developers using AI tools

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an MCP capable AI assistant run your existing pytest, Jest, or Cypress test suite and summarize failures

USE CASE 2

Generate a new Playwright or Maestro test file automatically from a page or screen analysis

USE CASE 3

Track flaky tests and get a prioritized fix-or-write-next plan after each test run

What is it built with?

PythonMCPPlaywrightMaestro

How does it compare?

kao273183/mk-qa-masteralex72-py/aria-termuxanime0t4ku/gentleman
Stars202020
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Zero install path via uvx, mobile testing needs the separate Maestro CLI and a simulator or device.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

mk-qa-master is a universal test runner exposed as a Model Context Protocol, or MCP, server, which means an AI assistant like Claude Desktop or Cursor can use it as a tool to run and understand your test suite directly. Instead of writing tests by hand or manually rerunning them, you point an MCP capable AI client at this server and it can execute tests, look at what failed, and suggest what to fix or write next. It supports a wide range of testing frameworks through a single interface: pytest and Playwright for Python, Jest and Cypress for JavaScript, Go's built in testing tool, Maestro for mobile testing on iOS, Android, and BlueStacks emulators, and as of recent versions, Schemathesis and Newman for testing APIs described by an OpenAPI schema or a Postman collection. Whichever framework is selected, results flow into the same reporting system, so history, flaky test tracking, and coaching advice all work the same way regardless of what kind of test just ran. Beyond running tests, the tool includes an analyzer that can look at a live web page or a mobile app screen and describe its forms, buttons, and navigation elements, which it can then use to generate a runnable test file with real selectors instead of empty placeholders. After a test run, a self improvement coach feature reviews the results across three angles, the quality of the test suite itself, how well the tool is being used, and how effective AI generated tests have been, and produces a prioritized list of what to fix or write next. Installing it is meant to be quick: the recommended path uses a tool called uvx to run the server without a permanent install, needing only a short snippet added to your MCP client's configuration file. A more traditional install into a Python virtual environment is also supported for people contributing to the project. It is released under the MIT license, with documentation in English and Traditional Chinese.

Copy-paste prompts

Prompt 1
Use mk-qa-master to run my pytest suite and summarize any failures with screenshots
Prompt 2
Analyze this web page with mk-qa-master and generate a Playwright test for its login form
Prompt 3
Get an optimization plan from mk-qa-master after my last test run

Frequently asked questions

What is mk-qa-master?

An MCP server that lets AI assistants run, analyze, and improve your test suite across pytest, Jest, Cypress, Go, and mobile testing.

What language is mk-qa-master written in?

Mainly Python. The stack also includes Python, MCP, Playwright.

What license does mk-qa-master use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is mk-qa-master to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is mk-qa-master for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.