# uimax-mcp

Audits a reachable web app with screenshots, Lighthouse, axe-core, and code analysis, then helps Claude Code apply fixes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: prembobby39-gif
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/prembobby39-gif/uimax-mcp
- Updated: 2026-03-29
- HTML: https://affpapa.org/en/nevibecode/mcp/uimax-mcp

## What it does

uimax-mcp takes a URL for a running application and builds a frontend review. It captures a Puppeteer screenshot, runs Lighthouse and axe-core, records Core Web Vitals, checks SEO signals, and inspects source code with AST analysis. The result covers Accessibility, Performance, Best Practices, SEO, and Code Quality grades.

Its tools also cover responsive screenshots, dark-mode checks, pixel comparisons, security checks, unused code, and standalone HTML reports. Claude Code receives the review method and can edit project files, while review history is stored in `.uimax-reviews.json`.

The app must be reachable from your machine, whether it runs on localhost, staging, or production. Without an accessible URL, the server cannot capture the page or run its audits. No API key is required.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add uimax-mcp -- npx -y uimax-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add uimax-mcp -- npx -y uimax-mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add uimax-mcp npx -y uimax-mcp
```

## When to use it
- review a running web interface
- find WCAG 2.1 accessibility violations
- measure Core Web Vitals and Lighthouse scores
- scan source code for frontend anti-patterns
- compare the UI before and after fixes

## Example prompts
- Review the app at `http://localhost:3000` and use `./src` as its source directory.
- Capture responsive screenshots, then check the page for accessibility and SEO issues.
- Run the audit again after the fixes and compare it with the previous review.

## Similar
- [accessibility](https://affpapa.org/en/nevibecode/skills/web-quality-skills-accessibility.md) — skill · 64100 installs
- [web-quality-audit](https://affpapa.org/en/nevibecode/skills/web-quality-skills-web-quality-audit.md) — skill · 32700 installs
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [lighthouse-mcp](https://affpapa.org/en/nevibecode/mcp/lighthouse-mcp.md) — MCP server · ★ 214
- [browser-qa](https://affpapa.org/en/nevibecode/skills/browser-qa.md) — skill · 4900 installs
- [a11y-debugging](https://affpapa.org/en/nevibecode/skills/a11y-debugging.md) — skill · 3600 installs

---
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