QA Agent Pro

Provides an MCP server that enables Claude or Cursor to automate QA tasks by navigating, clicking, capturing logs, and taking screenshots.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "samusilv-qa-agent-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/qa-agent-mcp/build/index.js"
      ]
    }
  }
}

QA Agent Pro provides an MCP server that equips Claude, Cursor, and other AI agents with executable browsing capabilities. It lets your AI test and QA websites by navigating, interacting, and capturing evidence such as logs and screenshots, enabling round-the-clock automated QA across devices.

How to use

You use QA Agent Pro by connecting it to your MCP client. Once linked, your AI can open websites, interact with elements just like a human user, simulate mobile viewports, capture console logs, and take screenshots at each step. This setup makes it practical to run ongoing QA tests and gather visual proof for reporting.

How to install

Prerequisites: Node.js and npm should be installed on your machine.

Clone the project repository.
Install dependencies and build the project.

git clone https://github.com/yourusername/qa-agent-mcp.git
cd qa-agent-mcp
npm install && npm run build

Configure QA Agent Pro to run from your Claude Desktop setup by adding the MCP server configuration.

{
  "mcpServers": {
    "qa_agent": {
      "command": "node",
      "args": ["/absolute/path/to/qa-agent-mcp/build/index.js"]
    }
  }
}

Try the demo

Validate the integration by running the included verification script to see the agent in action (Mobile + Desktop test).

node build/verify-qa.js

Available tools

navigate

Open a URL in a real Chrome browser, enabling automated page traversal.

click

Click a DOM element matching a selector to simulate user interactions.

type

Type text into an input or editable element identified by a selector.

set_viewport

Switch between viewport sizes to simulate mobile, tablet, and desktop views. Premium feature.

get_console_logs

Retrieve console logs to surface JavaScript errors and warnings.

screenshot

Capture a named screenshot at the current page state for visual proof.