ui-ux-pro-mcp
Provides CSS snippets, styling templates, and implementation checklists for various design styles like Glassmorphism and Minimalism.
Provides framework-specific design guidelines, state management recommendations, and UI implementation best practices for Flutter development.
Offers curated font pairing recommendations along with ready-to-use Google Fonts import configurations.
Includes a searchable database of Lucide icons with associated import codes and specific industry use cases.
Supplies specialized design intelligence and implementation patterns for Next.js, including App Router best practices.
Provides UI patterns and framework-specific guidelines for building applications with Nuxt.js and Nuxt UI.
Delivers React-specific design guidelines, hooks best practices, and patterns for both standard React and React Native.
Offers framework-specific design intelligence and implementation recommendations tailored for Svelte development.
Provides design system guidelines and implementation patterns specifically for SwiftUI development within the Swift ecosystem.
π¨ UI/UX Pro MCP Server
AI-powered UI/UX design intelligence β Instantly access 1,920+ curated design resources through natural language search.
β¨ Features
Feature | Details |
π 1,920+ Documents | Curated design knowledge across 11 domains + 2 platforms |
π§ 6 Tools | Consolidated search tools optimized for LLM performance |
β‘ BM25 Ranking | Fast, relevant search results using industry-standard text ranking |
π Universal | Works with VS Code, Claude Desktop, Cursor, and any MCP-compatible client |
π― 12 Frameworks | Stack-specific guidelines for React, Vue, Next.js, Flutter, SwiftUI, Jetpack Compose, and more |
π± Platform Guidelines | iOS Human Interface Guidelines (110) + Android Material 3 (112) with cross-platform equivalents |
Platform-Specific Design
iOS Human Interface Guidelines (110 patterns) β Colors, typography, navigation, gestures, accessibility with SwiftUI, Flutter, React Native code
Android Material 3 Design (112 patterns) β Dynamic color, typography, components, elevation, motion with Compose, Flutter, React Native code
Cross-platform code equivalents β Every pattern includes Flutter_Equiv and RN_Equiv for building native-feeling apps without native code
Auto-detection from keywords β Queries containing iOS/Android keywords automatically boost platform-specific results
Related MCP server: seedflip-mcp
π Quick Start
Option 1: NPX (Recommended)
npx ui-ux-pro-mcpOption 2: Global Install
npm install -g ui-ux-pro-mcp
ui-ux-pro-mcpOption 3: From Source
# Clone the repository
git clone https://github.com/redf0x1/ui-ux-pro-mcp.git
cd ui-ux-pro-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
npm startβοΈ MCP Configuration
VS Code / Cursor
Add to your MCP settings (settings.json or mcp.json):
Option A: Using NPX (Recommended - No Installation Required)
{
"mcpServers": {
"ui-ux-pro": {
"command": "npx",
"args": ["ui-ux-pro-mcp", "--stdio"]
}
}
}Option B: Using Global Install
{
"mcpServers": {
"ui-ux-pro": {
"command": "ui-ux-pro-mcp",
"args": ["--stdio"]
}
}
}Option C: From Source
{
"mcpServers": {
"ui-ux-pro": {
"command": "node",
"args": [
"/path/to/ui-ux-pro-mcp/dist/index.js",
"--stdio"
]
}
}
}Configuration file locations:
Platform | Path |
macOS |
|
Windows |
|
Linux |
|
Claude Desktop
Add to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Option A: Using NPX (Recommended - No Installation Required)
{
"mcpServers": {
"ui-ux-pro": {
"command": "npx",
"args": ["ui-ux-pro-mcp", "--stdio"]
}
}
}Option B: Using Global Install
{
"mcpServers": {
"ui-ux-pro": {
"command": "ui-ux-pro-mcp",
"args": ["--stdio"]
}
}
}Option C: From Source
{
"mcpServers": {
"ui-ux-pro": {
"command": "node",
"args": [
"/path/to/ui-ux-pro-mcp/dist/index.js",
"--stdio"
]
}
}
}π§ Available Tools
Tool | Documents | Description |
| 85 | UI design styles (Glassmorphism, Minimalism, Brutalism, etc.) with colors, effects, and use cases |
| 121 | Color palettes for industries (SaaS, Healthcare, Fintech) with hex codes |
| 74 | Font pairings with Google Fonts imports and Tailwind configs |
| 37 | Chart types with implementation recommendations for dashboards |
| 115 | UX best practices, do's and don'ts, accessibility (WCAG) |
| 176 | Curated Lucide icons with import codes and use cases |
| 49 | Landing patterns, Bento Grids (Config & Maps), Responsive Strategy |
| 114 | Product type design recommendations per industry |
| 39 | AI prompt templates with CSS snippets and implementation checklists |
| 696 | Framework-specific guidelines (React, Vue, Next.js, Flutter, etc.) |
| All | Unified search across all design domains |
| β | Generate complete design system with colors, typography, UI style, and layout in one call |
AI-Optimized Query Processing
The get_design_system tool uses intelligent query processing optimized for AI model consumers:
Position-Weighted Intent Classification
Queries are processed left-to-right with multi-word phrase priority:
Multi-word phrases first: "landing page", "admin panel", "hero section" have higher priority
Then single words: "dashboard", "landing", "analytics"
Position matters: Earlier keywords get higher confidence (5% penalty per word position)
Examples:
Query | Detected Intent | Reason |
"SaaS landing page dashboard" | landing | "landing page" phrase found |
"dashboard for SaaS landing" | dashboard | "dashboard" is first |
"admin panel with hero section" | dashboard | "admin panel" phrase beats "hero" |
"website for fintech startup" | landing | "website" maps to landing |
AI-Optimized Output Structure
The _meta field provides transparency for AI models:
{
"_meta": {
"query_interpretation": "SaaS landing page with glassmorphism (dark mode)",
"detected_intent": "landing",
"intent_confidence": 0.85,
"matched_keyword": "landing page",
"keyword_position": 1,
"warnings": []
}
}Dark Mode Color Parsing
When mode: "dark", the tool:
Searches for dark-mode compatible palettes
Parses
Dark_Mode_ColorsJSON from the databaseReplaces palette colors with dark mode equivalents
Includes both light and dark mode palettes in response
Code-Ready Snippets
Colors include ready-to-paste code:
{
"colors": {
"css_variables": "--primary: #0066FF; --background: #0A0E14; --text: #E5E5E5;",
"tailwind_config": "colors: { primary: '#0066FF', ... }"
}
}Layout Source Indicator
The layout.source field tells AI models where the layout recommendation came from:
"landing"- From landing page patterns database"dashboard"- From product's dashboard style recommendation
π¬ Example Prompts
Use these with Claude, Cursor, or any MCP-compatible AI:
π¨ Design Systems
"What UI style works best for a fintech dashboard?"
"Give me a color palette for a healthcare app"
"Find modern font pairings for a SaaS landing page"
π Data Visualization
"What chart type should I use for time-series data?"
"How do I make charts accessible?"
π₯οΈ Landing Pages
"Show me landing page patterns for SaaS conversion"
"What sections should a pricing page have?"
π± UX Guidelines
"What are mobile touch target best practices?"
"Show me accessibility guidelines for forms"
βοΈ Framework-Specific
"React hooks best practices"
"Vue 3 composition API patterns"
"Next.js App Router guidelines"
"Flutter state management recommendations"
π± Platform Guidelines (NEW)
"iOS navigation patterns"
"Android Material 3 color system"
"SwiftUI style without Swift" β Flutter/RN equivalents
"iOS typography guidelines with Flutter equivalent"
"Android dynamic color implementation"Platform Keyword Triggers
The search engine automatically detects platform intent from these keywords:
Platform | Trigger Keywords |
iOS |
|
Android |
|
Cross-Platform Query Examples
π iOS Design Without Swift
Query: "SwiftUI style flutter e-commerce"
Returns: iOS HIG patterns with Flutter_Equiv code (CupertinoWidgets)
π€ Android Material 3
Query: "material design android dashboard"
Returns: Material 3 patterns with Compose, Flutter, RN equivalents
π Cross-Platform Patterns
Query: "iOS navigation patterns react native"
Returns: iOS navigation guidelines with RN_Equiv implementationsπ Data Sources
This server aggregates curated design intelligence from multiple domains:
Domain | File | Count | Content |
Styles |
| 85 | UI design trends, effects, animations |
Colors |
| 121 | Industry-specific color palettes |
Typography |
| 74 | Font pairings and configurations |
Charts |
| 37 | Data visualization recommendations |
UX Guidelines |
| 115 | Usability and accessibility best practices |
Icons |
| 176 | Lucide icon recommendations |
Landing |
| 49 | Patterns, Bento Layout Maps, Responsive Strategy |
Products |
| 114 | Industry design recommendations |
Prompts |
| 39 | AI prompt templates |
Stacks |
| 766 | Framework-specific guidelines (12 stacks) |
iOS |
| 110 | iOS Human Interface Guidelines with cross-platform equivalents |
Android |
| 112 | Android Material 3 Design with cross-platform equivalents |
Available Framework Stacks:
flutter Β· html-tailwind Β· jetpack-compose Β· nextjs Β· nuxt-ui Β· nuxtjs Β· react-native Β· react Β· shadcn Β· svelte Β· swiftui Β· vue
Platform-Specific Guidelines:
ios (110 entries) Β· android (112 entries)
Platform data includes:
Flutter_Equiv: CupertinoWidgets/Material widget equivalents
RN_Equiv: React Native implementation patterns
Categories: Colors, Typography, Spacing, Components, Navigation, Gestures/Shapes, Animation/Motion, Icons, Layout, Accessibility
π API Reference
Common Input Parameters
All search tools accept:
Parameter | Type | Default | Description |
| string | required | Natural language search query |
| number | 3 | Maximum results to return (1-50) |
search_stack Additional Parameter
Parameter | Type | Description |
| string | Framework name: |
Response Format
All tools return results in this structure:
{
results: Array<{
id: string; // Document identifier
score: number; // BM25 relevance score
type: string; // Document type (style, color, etc.)
data: object; // Full document data
}>;
total: number; // Total results returned
query: string; // Original search query
}Error Response
{
error: string; // Error description
}π οΈ Development
Build Commands
# Build TypeScript to JavaScript
npm run build
# Development mode with hot reload
npm run dev
# Start production server (stdio mode)
npm start
# Start HTTP server for testing
npm run start:httpTesting
# Run test suite
npm testHTTP Mode for Testing
The server can run in HTTP mode for testing without MCP clients:
# Start HTTP server on port 3456
PORT=3456 npm run start:httpThen test with curl:
curl -X POST http://localhost:3456/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_colors","arguments":{"query":"fintech"}},"id":1}'Project Structure
ui-ux-pro-mcp/
βββ src/
β βββ index.ts # MCP server entry point
β βββ data/
β β βββ loader.ts # CSV data loading utilities
β βββ search/
β β βββ bm25.ts # BM25 search implementation
β βββ tools/
β βββ index.ts # Tool exports
β βββ handlers.ts # Search handlers
βββ data/
β βββ *.csv # Design domain data files
β βββ stacks/ # Framework-specific guidelines (12 stacks)
β βββ platforms/ # Platform guidelines (iOS HIG, Android M3)
βββ dist/ # Compiled JavaScript outputπ Environment Variables
Variable | Default | Description |
|
| Log level (debug, info, warn, error) |
|
| HTTP server port (when using HTTP transport) |
|
| HTTP server host |
π HTTP Transport Mode
For development and testing, you can run the server in HTTP mode:
# Start HTTP server
npm run start:http
# Server runs at http://localhost:3000
# SSE endpoint: GET /sse
# Message endpoint: POST /messageTest with curl:
curl -X POST http://localhost:3000/message \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_colors","arguments":{"query":"fintech"}}}'β Troubleshooting
MCP Connection Issues
"Cannot find MCP server"
Ensure
npm run buildcompleted successfullyCheck the path in your MCP config points to
dist/index.jsVerify Node.js is in your PATH
"No results returned"
Try broader search terms
Use
search_allfor cross-domain queriesCheck if the domain matches your query type
"Server not responding"
Restart VS Code/Claude Desktop
Check terminal for error messages
Verify the server process is running
Common Queries
Need | Best Tool |
Color palettes |
|
UI components |
|
Best practices |
|
Icons |
|
Framework tips |
|
Everything |
|
οΏ½ Contact
οΏ½π License
MIT License β see LICENSE for details.
π Acknowledgments
Original Data: Based on nextlevelbuilder/ui-ux-pro-max-skill
MCP SDK: Built with @modelcontextprotocol/sdk
Search: BM25 ranking algorithm for relevance scoring
β Star this repo if you find it useful!
Made with β€οΈ by redf0x1
Available Tools
7 toolsget_design_systemA
Generate a complete design system by combining styles, colors, typography, and layout patterns.
WHEN TO USE: Starting a new project, need cohesive design foundation, want all design elements in one call.
PLATFORM DETECTION: Platform is auto-detected from query keywords (iOS, Android, Flutter, etc.) or can be explicitly specified via the platform parameter.
If platform is specified, it overrides auto-detection
Platform affects navigation patterns, safe areas, touch targets
When iOS keywords (ios, swiftui, cupertino) or Android keywords (android, material 3, jetpack compose) are detected, returns platform_guidelines with HIG/Material patterns and cross-platform code equivalents (Flutter_Equiv, RN_Equiv)
INTENT DETECTION: Layout is auto-detected based on query structure:
Multi-word phrases take priority: "landing page" β landing layout
Single keywords scanned left-to-right: "analytics saas" β dashboard (analytics detected first)
Position matters: first intent keyword wins
INTENT KEYWORDS:
For landing layouts: "landing page", "homepage", "website", "hero", "cta"
For dashboard layouts: "dashboard", "analytics", "admin panel", "metrics", "kpi"
QUERY TIPS: Place intent keywords at START of query for highest confidence.
RETURNS: Integrated design system with _meta showing detected/resolved platform, intent, colors (with dark_mode if mode="dark"), typography, UI style, layout with source indicator, and platform_guidelines when iOS/Android detected.
EXAMPLES: "landing page fintech dark glassmorphism", "dashboard analytics saas", "e-commerce website luxury", "admin panel healthcare", "flutter fintech mobile", "ios finance app", "android material dashboard"
Inputs: query (required), style, mode, max_results, +3 more.
search_allA
Unified search across ALL design domains with intelligent auto-detection. Searches: styles, colors, typography, charts, icons, ux-guidelines, landing, products, prompts, platforms (iOS HIG, Android Material 3).
WHEN TO USE: DEFAULT tool for broad queries. Use when unsure which specific tool, or need multi-domain results.
PLATFORM DETECTION: Platform keywords (ios, swiftui, cupertino, android, material, jetpack compose) trigger platform-specific results with cross-platform code equivalents (Flutter_Equiv, RN_Equiv).
QUERY TIPS: Use natural language describing your design goal. System auto-detects relevant domains.
RETURNS: Results grouped by domain with relevance scores. Each domain returns its specific fields.
EXAMPLES: "modern fintech dashboard dark", "ios button design", "android navigation patterns", "e-commerce checkout ux", "startup landing complete"
Inputs: query (required), max_results.
search_componentsA
Search UI components: Lucide icons (176+) and chart types (37+) for data visualization.
WHEN TO USE: Finding icons for UI, selecting chart types for data.
TYPE FILTER (optional): icon | chart
RETURNS: Icon import codes with JSX, chart recommendations with library suggestions.
EXAMPLES: "user profile settings icon", "time series data chart", "analytics dashboard"
Inputs: query (required), type, max_results.
search_patternsA
Search design patterns: landing page layouts (60+), UX guidelines (130+), product type recommendations (117+).
WHEN TO USE: Page layouts, UX best practices, accessibility, navigation patterns.
TYPE FILTER (optional): layout | ux | product
RETURNS: Section structures, do/don't practices, conversion tips, code examples.
EXAMPLES: "hero section with CTA", "form validation best practices", "e-commerce product page"
Inputs: query (required), type, max_results.
search_platformsA
Search iOS Human Interface Guidelines or Android Material 3 design patterns specifically.
WHEN TO USE: iOS design patterns, SwiftUI style in Flutter, Material 3 patterns in React Native, platform-specific UI/UX.
RETURNS: Platform-specific patterns with cross-platform implementation code (Flutter_Equiv, RN_Equiv).
PARAMETERS:
query: Search query (e.g., 'button colors navigation')
platform_name: 'ios' or 'android' (optional, searches all if omitted)
max_results: Number of results (default 5)
EXAMPLES: "ios navigation patterns", "android material button", "swiftui style flutter", "ios safe area", "material 3 color system"
Inputs: query (required), platform_name, max_results.
search_stackA
Search framework-specific guidelines for: flutter, jetpack-compose, html-tailwind, nextjs, nuxt-ui, nuxtjs, react-native, react, shadcn, svelte, swiftui, vue.
WHEN TO USE: Framework-specific patterns, component best practices, state management.
QUERY TIPS: Include framework name AND topic.
RETURNS: Category, Guideline, Description, Do/Don't, Code Examples, Severity, Docs URL.
EXAMPLES: "react state management", "flutter animation", "swiftui navigation"
Inputs: stack_name (required), query (required), max_results.
search_stylesA
Search visual design elements: UI styles (70+), color palettes (100+), typography pairings (70+), and AI prompts (40+).
WHEN TO USE: Visual aesthetics, color schemes, font choices, CSS effects, design tokens.
DOMAIN FILTER (optional): style | color | typography | prompt
RETURNS: Style CSS code, color hex values with Tailwind config, font pairings with Google Fonts imports.
EXAMPLES: "glassmorphism dark mode", "fintech blue palette", "modern sans-serif pairing"
Inputs: query (required), domain, max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 7 tools
The tools have some overlap in functionality, particularly between search_all and the more specific search tools (search_components, search_patterns, search_platforms, search_stack, search_styles). While each tool has a distinct primary focus, an agent might be confused about when to use search_all versus the targeted tools, as search_all claims to cover 'ALL design domains' and is the 'DEFAULT tool for broad queries.' This overlap creates ambiguity, though the descriptions help clarify each tool's specific scope.
All tool names follow a consistent verb_noun pattern with snake_case. The tools are named get_design_system, search_all, search_components, search_patterns, search_platforms, search_stack, and search_styles. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.
With 7 tools, the count is well-scoped for a UI/UX design assistant server. Each tool serves a distinct purpose within the domain, such as generating design systems, searching across various design elements, or targeting specific platforms and frameworks. This number allows for comprehensive coverage without being overwhelming or too sparse.
The tool set covers a broad range of UI/UX design needs, including design system generation, component and pattern searches, platform-specific guidelines, and framework-specific advice. However, there are minor gaps, such as the lack of tools for creating or modifying design elements (e.g., no create_design or update_style tools), which might limit agent workflows that require iterative design changes. Overall, the surface is largely complete for search and retrieval operations in this domain.
Maintenance
Related MCP Connectors
SVG Lab MCP: the Design Engine for AI. App screens, icons, illustrations and charts as SVG.
UI design that stands out. Full-screen UI references and design materials for coding agents.
Curated design references for AI β real CSS values, typography specs, and color palettes.
Orvain UI design system for React and Vue: real component props, variants and tokens for AI tools
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceStructured design references from 1,000+ curated websites for AI-powered web design. Retrieve real CSS values, typography specs, color palettes, and design rationale via MCP.1MIT
- AlicenseNot gradedqualityDmaintenanceGive your AI coding agent design taste. 104 curated design seeds with colors, fonts, spacing, and shadows. Query by vibe, brand, or style.79 npmMIT
- AlicenseAqualityCmaintenanceProvides 1000+ handcrafted design system themes (colors, typography, components, animations) to inject into AI-generated UI, enabling tools like Claude, ChatGPT, and Cursor to produce polished, non-generic interfaces.29 npm1MIT
- FlicenseAqualityNot gradedmaintenanceMCP server enabling AI agents to search, retrieve details, and compare UI components from 13 popular UI libraries.3-