vibecraft-mcp
VibeCraft MCP is a free MCP server that brings deterministic UI/UX intelligence, AST-based auto-fixing, and backend performance auditing into AI coding agents.
Audits React/Tailwind UI for UX anti-patterns: focus outline stacking, competing primary CTAs, sub-44px touch targets, hardcoded hex colors, SVG edge clipping, and missing navigation states.
Automatically fixes UX compliance issues with AST transformations: 4px spacing grid alignment, nested corner radius math, semantic HSL color tokens, single focus rings, and
aria-currentinjection.Fetches design tokens, layout blueprints, UX guidelines, and design system rules from embedded frameworks like shadcn/ui, NN/g, Laws of UX, and Apple HIG.
Searches and retrieves ready-to-use React + Tailwind + Framer Motion component code from 21st.dev and curated registries.
Audits backend/database/network/frontend performance: N+1 queries, sequential promise waterfalls, missing transactions, IDOR security risks, and slow OFFSET pagination.
Performs LRU-cached BM25 RAG search over UX design intelligence guidelines.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@vibecraft-mcp Audit my dashboard component for UX anti-patterns and suggest fixes."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🚀 VibeCraft MCP (vibecraft-mcp) v3.2.0
Deterministic UI/UX Intelligence, AST Auto-Fixer & Systems Performance Engine for AI Vibe-Coding.
VibeCraft MCP is a 100% free, open-source Model Context Protocol (MCP) server that embeds real-world UI Engineering, UX Product Psychology, AST Code Refactoring, and Backend Performance Auditing directly into your AI coding agent sessions (Google Antigravity, Cursor, Windsurf, Claude Code).
It permanently eliminates AI Slop—generic, un-styled, un-accessible, double-focus-stacking, clipped SVG, N+1 query-heavy code—by enforcing proven design system contracts and automated code transformers.
⚡ 1-Click Quickstart Setup (100% Free)
Add vibecraft-mcp to your IDE's mcp_config.json (Cursor, Antigravity, Windsurf, Claude Code).
Method 1: Direct from GitHub (Instant & 100% Free)
{
"mcpServers": {
"vibecraft-mcp": {
"command": "npx",
"args": [
"-y",
"github:originsatyam/vibecraft-mcp"
],
"env": {
"UI_UX_MCP_API_KEY": "your_api_key_here"
}
}
}
}Method 2: Local Node Execution
{
"mcpServers": {
"vibecraft-mcp": {
"command": "node",
"args": [
"/path/to/vibecraft-mcp/dist/index.js"
],
"env": {
"UI_UX_MCP_API_KEY": "your_api_key_here"
}
}
}
}Related MCP server: MCP Policy Gatekeeper
🛠 The 10 Core MCP Tools
1. fix_ux_compliance (NEW in v3.2.0)
Deterministic AST Code Transformer Engine. Automatically repairs UI/UX anti-patterns in TSX/JSX code:
Arbitrary Spacing: Re-aligns
p-[13px]orgap-[15px]to standard 4px spatial grid tokens (p-3,gap-4).Nested Corner Math: Corrects inner child radiuses using $R_{\text{inner}} = \max(0, R_{\text{outer}} - P_{\text{inset}})$.
Hardcoded Colors: Replaces hex colors (
bg-[#000]) with theme-aware HSL semantic tokens (bg-card).Single Focus Ring: Injects
focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2to eliminate stacked focus outlines.Navigation State: Appends
aria-current="page"strictly to active route links.
2. audit_ux_compliance
Babel AST parser engine auditing React & Tailwind code for UX anti-patterns:
Double focus outline stacking on inputs and buttons.
SVG line/area chart edge stroke clipping.
Missing navigation state grammar (
DEFAULT,HOVER,ACTIVE,SELECTED).Competing primary CTA buttons (
bg-primaryon 3+ controls).Touch targets smaller than 44x44px.
3. get_design_tokens
Provides ready-to-copy globals.css HSL CSS variables, typography scales, spatial grid, icon stroke rules, glassmorphism backdrop blurs, shadcn/ui CVA contracts, and Figma extracted design formulas.
4. get_layout_blueprint
Retrieves Nielsen Norman Group (NN/g) Information Architecture macro layout scaffolds:
saas-dashboard— Collapsible sidebar, top utility header, stat grid, filterable data table.saas-settings— Task-oriented vertical tabs with sticky unsaved changes bar.ai-generation-pattern— AI co-pilot streaming prompt container and action bar.destructive-confirm-pattern— Double-confirmation safety dialog with undo ledges.
5. get_ux_guidelines
Queries embedded design principles & product psychology rules:
Frank Chimero's TSOD: 3 Levers (Message, Tone, Format), How vs Why Balance.
Nir Eyal's Hook Model: Habit loops ($B=MAT$ action friction reduction, variable rewards, investment).
Interaction Design Foundation (IxDF): Morville 7 Factors Honeycomb, Quesenberry 5 Cs.
Laws of UX & Growth.design: Hick's Law, Fitts's Law (44px touch targets), Doherty Threshold (<400ms skeleton UI).
6. audit_system_performance
Audits backend code and database queries:
N+1 DB Query Elimination: Refactors loop queries to ORM
include/JOIN FETCH.Sequential Promise Waterfalls: Parallelizes independent calls with
Promise.all().Transaction Safety: Wraps multi-step mutations in
db.$transaction()with automatic rollback.OWASP IDOR Security: Validates tenant/user ownership checks (
WHERE id = params.id AND tenantId = user.tenantId).
7. search_ui_components
Searches 21st.dev and curated component registry by keyword, category, or tag (Glowing cards, Floating magnetic docks, Bento grids).
8. get_component_code
Retrieves copy-paste ready React + Tailwind CSS + Framer Motion code with shadcn CLI install commands. Supports live HTTP fallback fetching.
9. get_design_system_rules
Retrieves structured design system rules, Tailwind v4 / v3 mappings, and font priority scale (SF Pro, Inter, Geist, Helvetica).
10. rag_search_ux
LRU cached BM25 relevance ranking vector query engine over design intelligence guidelines.
🎨 Dual Trained Intelligence Systems
System 1: Figma iOS 18 Design Intelligence Extraction
Concentric Corner Math: $R_{\text{inner}} = \max(0, R_{\text{outer}} - P_{\text{inset}})$.
Touch Target Constraint: $44\text{px} \times 44\text{px}$ minimum bounding box for mobile/tablet tap precision.
Layered Surface Density:
Ultrathin/Thinfor persistent backgrounds;Regular/Thickfor transient overlays & modal dialogs.SVG Stroke Padding: $P_{svg} = \max(8\text{px}, \text{strokeWidth} \times 2)$ with
overflow: visible.
System 2: shadcn-ui/ui Component Architecture (479 Components Scanned)
Class Variance Authority (CVA) Variant Matrices: Standardized variant contracts (
variant,size,h-8,h-9,h-10,h-11).Concentric Radius CSS Variables:
--radius-lg: var(--radius),--radius-md: calc(var(--radius) - 2px),--radius-sm: calc(var(--radius) - 4px).Headless Accessibility Markers: Radix UI
data-state="open|closed",aria-expanded,aria-invalid,aria-selected.
📚 Embedded Frameworks Matrix
Framework | Core Concept | Purpose in Vibe-Coding |
Frank Chimero's TSOD | 3 Levers (Message, Tone, Format) | Ensures design choices match user context & utility. |
Nir Eyal's Hook Model | Trigger $\rightarrow$ Action $\rightarrow$ Reward $\rightarrow$ Investment | Builds habit-forming SaaS features and delight loops. |
Nielsen Norman Group | Information Architecture (IA) | Prevents broken, chaotic SaaS page layouts. |
shadcn/ui & Radix UI | Headless Primitives & CVA | Production-grade accessible component primitives. |
Apple HIG & WCAG AAA | Touch targets & Focus | Mandates 44x44px touch targets and single focus ring. |
transitions.dev | Shared Element Motion | Physics spring timing ( |
👤 Author & Contribution
Developed by Satyam (@originsatyam).
Contributions, issues, and feature requests are welcome!
git clone https://github.com/originsatyam/vibecraft-mcp.git
cd vibecraft-mcp
npm install
npm run build📄 License
MIT © originsatyam
Available Tools
7 toolsaudit_system_performanceA
Audits backend API code, database queries, network waterfalls, and frontend rendering for performance bottlenecks, N+1 queries, un-transactional mutations, IDOR security issues, and slow OFFSET pagination.
Inputs: codeOrQuery (required), scope.
audit_ux_complianceB
Audits UI code or prompt specs against AI-slop prevention matrix, competing primary CTAs, TSOD levers, Design System 13-state matrix, Laws of UX, Apple HIG, Hook Model habit loops, IxDF principles, hardcoded hex colors, and icon accessibility.
Inputs: codeOrPrompt (required), componentType.
get_component_codeA
Retrieves complete React, Tailwind, Framer Motion source code, demo, and dependencies for a component. Supports fallback live fetching.
Inputs: slug (required), registryUrl.
get_design_tokensA
Provides HSL CSS color variables, globals.css setup, typography scales, spatial grid, icon stroke rules, shadows, and spring animation parameters.
Inputs: category.
get_layout_blueprintA
Retrieves Nielsen Norman Group (NN/g) Information Architecture (IA) macro page layout scaffolds and Design System Task Patterns (AI Co-pilot generation, Destructive actions, SaaS Dashboards, Settings, Onboarding, Pricing).
Inputs: id, type.
get_ux_guidelinesC
Queries UX Intelligence Rules: AI-Slop Prevention Matrix, Source of Truth Hierarchy, Frank Chimero's TSOD 3 Levers, Design System 13-State Matrix, Apple HIG, Laws of UX, Nir Eyal's Hook Model, IxDF Foundations, NN/g IA, and transitions.dev rules.
Inputs: topic, category.
search_ui_componentsB
Searches 21st.dev & curated high-craft UI component registry by keyword, category, or tag.
Inputs: tag, query, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clear boundaries, but audit_ux_compliance and get_ux_guidelines reference nearly the same set of UX rules and heuristics, making their purposes easy to confuse. get_layout_blueprint also overlaps with get_ux_guidelines via NN/g IA content, though the descriptions help differentiate them.
All tools follow a consistent verb_noun snake_case pattern: audit_*, get_*, search_*. This makes the toolset predictable and easy to navigate.
Seven tools is well-scoped for a design/UX assistant server. Each tool covers a distinct part of the workflow: auditing, guidelines, layout, components, and design tokens, without feeling bloated or thin.
The toolset covers the core design/UX loop well: retrieve guidelines and tokens, find and fetch components, and audit both system performance and UX compliance. Minor gaps exist, such as no explicit tool for applying fixes or generating a consolidated audit report, but agents can work around these.
Maintenance
Related MCP Connectors
Enforces architectural invariants and code quality rules inside your AI agent's edit loop.
Scores your code across 12 areas, with findings, fix prompts, and re-assessment in your AI agent
A design agent in your coding agent's loop: briefs each screen, reviews UX and visual quality.
UX guidelines and audits for coding agents. Paid plans start audits, heatmaps and user simulations.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI coding agents to generate standardized code using scaffolding templates, enforce architectural patterns, and validate outputs programmatically. Supports creating projects from boilerplates and adding features to existing codebases while maintaining team conventions.160AGPL 3.0
- FlicenseAqualityDmaintenanceProvides real-time policy enforcement for AI coding agents by intercepting and validating their actions against organizational standards like naming conventions, security policies, and compliance rules before execution. Prevents violations through immediate feedback and auto-correction suggestions.5-

corbatofficial
AlicenseAqualityDmaintenancePolicy and quality engine for AI coding agents that enforces team coding standards and provides validation gates for agent-assisted software delivery.754 npm5MIT- FlicenseNot gradedqualityCmaintenanceProvides AI coding agents with real-time access to compliance rules, scan results, and remediation guidance to enforce coding standards and security policies on generated code.-