UI/UX Suite
Design bugs by line number in CSS, JSX, HTML and Tailwind, each with the measured value and the fix.
At a glance
Not tested yet- GitHub stars
- 8
- Weekly downloads
- 956
- Last commit
- 2026-11-17
- Licence
- MIT
- Transport
- stdio
- Auth
- none
npx -y ui-ux-suite
What it does
UI/UX Suite is an MCP server that reads your source code and reports design problems by file and line number, each with a suggested fix. It measures contrast against WCAG 2.2 and cites a WCAG rule or UX law for each finding. It gives a score out of 10 and lists the three fixes to do first. It is for people building web projects who want a design and accessibility check before shipping or on each push.
Tools it gives your agent
The README says the MCP server exposes 16 tools but does not name them or describe what each one does. It does describe the audit output: located findings with a file and line, a cited WCAG rule or UX law, and the measured value with the change to make.
Quick start
- Install the skills for your agent.
npx skills add Aboudjem/ui-ux-suite -g
- Add the MCP server once, since the skills call it.
claude mcp add -s user ui-ux-suite -- npx -y ui-ux-suite --mcp
- Point it at a project.
npx ui-ux-suite .
- Fix the three lines at the top of the report. Each names a file, a line and the change to make.
- Optional: put it in CI.
npx ui-ux-suite . --fail-under 7 npx ui-ux-suite . --json | jq npx ui-ux-suite . --html report.html npx ui-ux-suite . --sarif ui-ux.sarif npx ui-ux-suite . --write-baseline .uiux-baseline.json npx ui-ux-suite . --baseline .uiux-baseline.json --fail-on-regression npx ui-ux-suite . --tags dimension:accessibility --exclude-tags severity:nice-to-have
In an agent, ask for it in plain words: "audit this project's design". In Claude Code, type /ui-ux-suite:audit.
Add it to Claude Code from a terminal:
claude mcp add ui-ux-suite -- npx -y ui-ux-suite
Or add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"ui-ux-suite": {
"command": "npx",
"args": [
"-y",
"ui-ux-suite"
]
}
}
}Environment variables
The registry entry declares no environment variables.
Example prompts
- Audit this project's design and show me the three fixes to do first.
- Check the contrast in my styles and tell me which lines fail WCAG AA.
- Find places where keyboard focus is not visible and give me the fix for each line.
- Run the design audit and save today's findings as a baseline.
What to watch out for
- It reads source, not pixels, and a high score does not prove WCAG conformance.
- The CLI has no deep flag. Deep mode, which checks the running app in a real browser, runs through another path.
- Cursor does not start a new server until you approve it with
cursor-agent mcp enable ui-ux-suite. - Gemini CLI disables every MCP server in a folder it does not trust. Run
geminithere once and pick "Trust folder". - The skills install adds the 14 skills only. The MCP server is a separate line.
- The README states no API key is needed.
Not tested by tools4agents yet. Read the source repository before you install it.
Similar tools
Blender MCP Server
Connects Blender to AI coding assistants via MCP for prompt-assisted 3D modeling, material creation, and scene inspection.
Pascal 3D Editor
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Figma Context MCP Server
Gives coding agents direct access to Figma component structures, tokens, and layouts for accurate UI implementation.
Unity MCP Server
Connects Unity Editor to AI coding agents to control scene hierarchies, edit scripts, inspect game objects, and manage assets.