Uimax MCP logo

Uimax MCP

uimax-mcp reviews web UIs with screenshots, audits, code analysis, browser controls, reports, and baseline comparisons.

Install Uimax MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "uimax-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "uimax-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y uimax-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 24d ago.

Overview

The uimax-mcp MCP server gives Claude Code browser-based tools for reviewing and debugging web interfaces. It captures screenshots, runs Lighthouse, axe-core, SEO, performance, security, and PWA checks, and analyzes source code with configurable rules. Use it for localhost, staging, or production URLs that the machine can reach, especially when you need an audit followed by fix verification.

Use cases

  • Review a localhost frontend for accessibility, SEO, performance, and code issues
  • Verify UI fixes with before-and-after grades and resolved issue counts
  • Compare two sites across accessibility, performance, and SEO
  • Capture responsive screenshots and pixel-level visual differences
  • Inspect browser console, network, and runtime errors

Key features

  • Automated UI review pipeline
  • Lighthouse, axe-core, SEO, and performance audits
  • AST-based frontend code analysis
  • Browser interaction and diagnostics
  • Screenshot comparison and responsive capture
  • Review history, baselines, and budget checks

Tools37

What Uimax MCP lets your agent do. Expand a tool for its parameters.

Self-reported~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

10/10 checks healthy over the last 61d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · uimax-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads268Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed37Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Uimax MCP works

What uimax-mcp does

The uimax-mcp MCP server connects an MCP client to a browser-driven frontend review workflow. Its main pipeline, review_ui, combines a page screenshot with Lighthouse scores, axe-core findings, Core Web Vitals, SEO checks, source-code analysis, letter grades, and a review methodology. Results are stored in project review history so later runs can show changes.

The server can also review a narrower concern. quick_review focuses on visual design, while lighthouse_audit, seo_audit, accessibility_audit, performance_audit, security_audit, and pwa_audit target specific areas.

How it works

A request supplies a reachable URL and, where relevant, a source-code path. Browser automation uses Puppeteer to navigate, wait for network idle, capture images, inspect elements, and perform actions such as clicking, typing, selecting options, and scrolling. Diagnostic tools collect console messages, network requests, JavaScript exceptions, unhandled rejections, and failed resource loads.

Visual checks include responsive captures at 375px, 768px, and 1440px, light-versus-dark comparisons, pixel-level diffs, and before/after semantic comparisons. Performance checks cover metrics such as FCP, LCP, CLS, TBT, DOM node count, and JavaScript heap size. Code analysis uses the TypeScript compiler API for JavaScript and TypeScript rules, with a regex fallback for non-JavaScript files.

The uimax-mcp MCP server can compare a new audit with a prior review or saved baseline. verify_fixes reports grade transitions, resolved issues, and an improved, regressed, or mixed result. Baseline and history tools support score trends, recurring issues, problematic files, and review-to-review differences.

Setup and configuration

Add the server to Claude Code with:

Terminal
claude mcp add uimax -- npx -y uimax-mcp
Terminal
npm install -g uimax-mcp

The target application must be reachable from the machine running the browser. Source analysis can be configured with a .uimaxrc.json file; the same file can define performance budgets used by check_budgets. Review records are written to .uimax-reviews.json, while baseline data uses .uimax-history.json.

Tools and capabilities

  • Run complete reviews, quick design reviews, fix verification, side-by-side site comparisons, and embedded HTML report exports.
  • Capture high-resolution, responsive, dark-mode, pixel-diff, and semantic-comparison screenshots.
  • Inspect Lighthouse categories, 18 documented SEO signals, WCAG 2.1 Level A and AA issues, PWA readiness, security conditions, unused assets, LCP details, and resource usage.
  • Analyze code for more than 25 documented rules and report exact byte savings for unused JavaScript and CSS.
  • Navigate pages and interact with controls using selectors, typed text, dropdown values, scrolling, and element waits.
  • Save baselines, enforce configured budgets, inspect review history and statistics, and compare individual reviews.

Limitations and notes

quick_review intentionally omits code analysis and performance auditing. Code analysis has different behavior for JavaScript files and other file types because non-JavaScript files use a regex fallback.

The uimax-mcp MCP server reports audit data and review methodology, but the documented fix workflow relies on Claude Code applying changes to the project. Audit scores, visual diffs, and grade transitions should therefore be interpreted as measurements of the current page and configuration, not as proof that every issue has been corrected.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Uimax MCP

uimax-mcp is an MCP server that connects Claude Code to browser-based frontend review tools for reachable web URLs. Its main tools include review_ui for combined screenshots, Lighthouse, axe-core, SEO, performance, and code analysis; verify_fixes for before-and-after checks; and screenshot, audit, interaction, and reporting tools.

Install it in Claude Code with `claude mcp add uimax -- npx -y uimax-mcp`. It states that no API key is needed.

Yes. `verify_fixes` reruns the full audit, compares it with the previous review, reports grade transitions and resolved issues, and labels the result improved, regressed, or mixed.

It can review localhost, staging, production, or any other URL reachable from the machine running it.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewUimax MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/uimax-mcp?style=directory)](https://allmcps.com/mcp/uimax-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/uimax-mcp"><img src="https://allmcps.com/api/badge/uimax-mcp?style=directory" alt="Uimax MCP on AllMCPs" /></a>