README.md•2.33 kB
<div align="center">
<img src="logo.png" alt="QA Agent Pro Logo" width="200"/>
<h1>🕵️ QA Agent Pro</h1>
<p><strong>The "AI Tester" for Claude & Cursor</strong></p>
</div>
> **Stop testing manually. Let AI do the boring work.**
**QA Agent Pro** is a Model Context Protocol (MCP) server that gives your AI (Claude, Cursor, etc.) **eyes and hands** to browse the web. It turns your AI into a tireless QA Engineer that can test your website 24/7.
## 🚀 Why QA Agent Pro?
- **📱 Mobile Simulation:** Test your responsive design on iPhone, Pixel, or iPad views instantly.
- **🚨 Bug Hunter:** Automatically captures hidden JavaScript errors (Console Logs) that break your app.
- **📸 Visual Proof:** Takes screenshots of every step, so you have evidence of what works (and what doesn't).
- **⚡ Zero Config:** Connects to Claude Desktop in seconds.
## 🛠️ Capabilities (Tools)
Your AI gains these superpowers:
1. `navigate(url)`: Open any website in a real Chrome browser.
2. `click(selector)` & `type(selector, text)`: Interact like a real user.
3. `set_viewport(width, height, mobile)`: **[PREMIUM]** Simulate mobile devices.
4. `get_console_logs()`: **[PREMIUM]** Extract error logs for debugging.
5. `screenshot(name)`: Capture visual evidence.
## 📦 Installation
1. Clone this repo:
```bash
git clone https://github.com/yourusername/qa-agent-mcp.git
cd qa-agent-mcp
```
2. Install & Build:
```bash
npm install && npm run build
```
3. Add to Claude Desktop Config:
```json
{
"mcpServers": {
"qa-agent": {
"command": "node",
"args": ["/absolute/path/to/qa-agent-mcp/build/index.js"]
}
}
}
```
## 💰 Pricing & Licensing
This tool is available for:
- **Personal Use:** Free for open source projects.
- **Commercial License:** $49 (Lifetime access).
[](https://samuverse7.gumroad.com/l/fjhfd)
> **Corporate/Agency Use:** If you are using this tool to test client websites or commercial products, you must purchase a license.
## 🧪 Try the Demo
Run the included verification script to see the agent in action (Mobile + Desktop test):
```bash
node build/verify-qa.js
```
---
*Built with ❤️ by [Your Name]*