# ghost-qa

The ghost-qa MCP server for Claude Code and Codex checks a running web app in a browser. It visits internal routes and reports runtime, network, and layout issues.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 50 repo stars
- Author: avivgerz-hue
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/avivgerz-hue/ghost-qa
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ghost-qa

## What it does

ghost-qa launches a headless browser, visits internal routes in a running app, and tests interactive controls. Its checks cover three viewport sizes in both light and dark themes. The server catches JavaScript errors, failed requests, and layout problems, then returns a diagnostic report with selectors for fixes.

After changes, the check can run again; compare two runs with `ghost-qa compare before.json after.json`. It requires Node.js 20 or newer, a running app server, and Chromium. Install the browser with `npx playwright install chromium`. Without a running app, ghost-qa has no pages to inspect.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ghost-qa -- npx -y ghost-qa
```

### Codex

**Platform CLI**
```bash
codex mcp add ghost-qa -- npx -y ghost-qa
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ghost-qa": {
            "command": "npx",
            "args": [
                "-y",
                "ghost-qa"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ghost-qa": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ghost-qa"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ghost-qa npx -y ghost-qa
```

## When to use it
- catch JavaScript errors while pages load
- find failed API requests and broken assets
- check layouts across viewport sizes
- compare QA results before and after changes

## Example prompts
- Check the app at `http://localhost:3000` and report browser issues.
- Run the browser check again after my changes.
- Compare `before.json` with `after.json` and report new regressions.

## Similar
- [Ghost](https://affpapa.org/en/nevibecode/mcp/ghost.md) — MCP server · ★ 28 repo stars
- [ghost-validate](https://affpapa.org/en/nevibecode/skills/ghost-validate.md) — skill · 4200 installs
- [Ghost CMS MCP Server](https://affpapa.org/en/nevibecode/mcp/ghost-cms-mcp-server.md) — MCP server · 4363 installs
- [ghost-scan-code](https://affpapa.org/en/nevibecode/skills/ghost-scan-code.md) — skill · 5700 installs
- [ghost-bits-cast-attack](https://affpapa.org/en/nevibecode/skills/ghost-bits-cast-attack.md) — skill · 3700 installs
- [Ghost in the Droid](https://affpapa.org/en/nevibecode/mcp/ghost-in-the-droid.md) — MCP server · ★ 431 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
