ghost-qa — Claude Code MCP server: browser QA and setup
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.
MIT ★ 50 updated 2026-11-14
claude mcp add ghost-qa -- npx -y ghost-qaWhat ghost-qa 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.
What it helps with
- 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 for the agent
- Check the app at
http://localhost:3000and report browser issues. - Run the browser check again after my changes.
- Compare
before.jsonwithafter.jsonand report new regressions.
How to install ghost-qa
Platform CLI
claude mcp add ghost-qa -- npx -y ghost-qaPlatform CLI
codex mcp add ghost-qa -- npx -y ghost-qaConfig file
{
"mcpServers": {
"ghost-qa": {
"command": "npx",
"args": [
"-y",
"ghost-qa"
]
}
}
}Config file
{
"servers": {
"ghost-qa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ghost-qa"
]
}
}
}Platform CLI
gemini mcp add ghost-qa npx -y ghost-qaStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ghost-qa
How do I install ghost-qa in Claude Code?
Run claude mcp add ghost-qa -- npx -y ghost-qa.
What does ghost-qa do?
It checks a running web app in a browser, visits internal routes, and reports runtime, network, and layout problems.
What does ghost-qa need to run?
It needs Node.js 20 or newer, a running app server, and Chromium. Install Chromium with npx playwright install chromium.