Which integrations are available for this server?

Provides integration with Chakra UI as a package-based UI component source, allowing discovery and installation of Chakra UI components. Provides integration with Mantine as a package-based UI component source, allowing discovery and installation of Mantine components. Provides integration with MUI (Material UI) as a package-based UI component source, allowing discovery and installation of MUI components. Enables discovery, inspection, and installation of UI components from the shadcn/ui registry with compatibility resolution and integrity tracking.

How do I use UIShelf MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@UIShelf MCP Server find an animated pricing section that fits my stack and dry-run install it" 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.

UIShelf MCP Server

by SH20RAJ

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

💡 What is UIShelf?

UIShelf is NOT another UI component library.
UIShelf is the resolution layer and universal discovery engine between developers and the entire React UI ecosystem.

Rather than maintaining a hardcoded catalog, UIShelf operates as a dynamic multi-platform aggregator and search proxy. When you search, it queries remote platforms concurrently using their native schemas and endpoints. When you install, it executes their upstream CLI commands in the background while giving you a single, unified uishelf add interface!

Core Promise:
Search every great UI source → Understand compatibility → Preview & inspect → Choose the best component → Install safely.

Everything runs on the exact same core engine across all interfaces:

🌐 Web Platform: Interactive search catalog, preview drawer, provider analytics, library comparison (/compare).
⚡ Interactive CLI (uishelf): Instant component discovery, dry-run install plans, doctor diagnostics, smart add.
🤖 Model Context Protocol (MCP): Native stdio & remote tools allowing Cursor, Claude, Antigravity, and Windsurf AI agents to safely discover, inspect, and install UI components.

Related MCP server: ui-registry-mcp

⚡ Dynamic Multi-Platform Aggregation & Background Execution

Remote Search Proxy: Searching e.g. uishelf search button queries official shadcn registries (/r/index.json), Magic UI, Aceternity, 21st, React Bits, Ruixen, Cult UI, ReUI, Kokonut UI, and NPM package registries in parallel with an automatic 2.5s network timeout and instant local caching.
Unified Developer Interface: You only ever need to run:
```
uishelf add <component-id>
```
Native Commands Run in Background: UIShelf runs the upstream provider's native command in the background (npx shadcn@latest add ..., pnpm add @mui/material ..., npx 21st@latest add ...) adapted to your package manager (pnpm dlx, bunx --bun, or npx).
Automatic Transactional Fallback: If the upstream CLI tool fails or if you are offline, UIShelf automatically falls back to its built-in transactional file and dependency installer, ensuring installations never fail!

📦 Supported Libraries & Discovery Matrix

Inspect all supported libraries directly in your terminal via uishelf providers list or uishelf libs:

Library / Registry	Type	Search Schema / Endpoint	Background Install Command	Stacks Supported	Key Capabilities
shadcn/ui	`shadcn-registry`	Remote Index (`https://ui.shadcn.com/r/index.json`)	`npx shadcn@latest add {name} --yes`	Tailwind v3/v4, React 19, Radix	WAI-ARIA Accessible, Zero-runtime CSS
Magic UI	`shadcn-registry`	Remote Index (`https://magicui.design/r/index.json`)	`npx shadcn@latest add "https://magicui.design/r/{name}.json" --yes`	Tailwind v3/v4, React 19, Motion	200+ Animated items, Canvas shaders, Bento
Aceternity UI	`shadcn-registry`	Remote Index (`https://ui.aceternity.com/r/index.json`)	`npx shadcn@latest add "https://ui.aceternity.com/r/{name}.json" --yes`	Tailwind v3/v4, React 19, Motion	Radiant Hero sections, 3D Pin, Lamp effect
21st.dev	`cli`	Marketplace API (`https://21st.dev/api/registry/index`)	`npx 21st@latest add {name}`	Tailwind v3/v4, React 19, Motion	Marketplace, Creator registry, Multi-style
React Bits	`shadcn-registry`	Remote Index (`https://reactbits.dev/r/index.json`)	`npx shadcn@latest add "https://reactbits.dev/r/{name}.json" --yes`	Tailwind v3/v4, React 19, Motion	Physics text, Magnetic cursor, Ballpit
Ruixen UI	`shadcn-registry`	Multi-Stack API (`https://ruixen.com/r/index.json`)	`npx shadcn@latest add "https://ruixen.com/r/{name}" --yes`	Tailwind v4/v3, Radix, Base UI	Multi-stack variant selector
Cult UI	`shadcn-registry`	Remote Index (`https://cult-ui.com/r/index.json`)	`npx shadcn@latest add "https://cult-ui.com/r/{name}.json" --yes`	Tailwind v3/v4, React 19, Motion	Tactile neumorphism, Cyberpunk blocks
ReUI	`shadcn-registry`	Remote Index (`https://reui.io/r/index.json`)	`npx shadcn@latest add "https://reui.io/r/{name}.json" --yes`	Tailwind v3/v4, React 19	SaaS hero blocks, Notification banners
Animate UI	`shadcn-registry`	Remote Index (`https://animate-ui.com/r/index.json`)	`npx shadcn@latest add "https://animate-ui.com/r/{name}.json" --yes`	Tailwind v3/v4, React 19, Motion	Spring physics primitives, Morphing dialogs
Kokonut UI	`shadcn-registry`	Remote Index (`https://kokonutui.com/r/index.json`)	`npx shadcn@latest add "https://kokonutui.com/r/{name}.json" --yes`	Tailwind v3/v4, React 19, Lucide	AI prompt inputs, Interactive commands
MUI (Material UI)	`package-library`	NPM Search API (`@mui/material`)	`pnpm add @mui/material @emotion/react @emotion/styled`	Emotion, MUI System, React 18/19	Google Material Design 3, DataGrid
Mantine	`package-library`	NPM Search API (`@mantine/core`)	`pnpm add @mantine/core @mantine/hooks`	PostCSS, CSS Modules, React 18/19	100+ components, 50+ hooks, Dark theme
Chakra UI	`package-library`	NPM Search API (`@chakra-ui/react`)	`pnpm add @chakra-ui/react @emotion/react`	Emotion, React 18/19	Style props DX, Accessible WAI-ARIA

🛠️ CLI Commands

uishelf init                 # Initialize UIShelf in current project
uishelf search <query>       # Hybrid search across all registries (alias: uishelf s)
uishelf browse               # Interactive component browser
uishelf inspect <component>  # Deep dive into component code, AST, and dependencies
uishelf add <component>      # Install component with dependency resolution (alias: uishelf a)
uishelf remove <component>   # Safely uninstall component and update lockfile
uishelf update               # Check for upstream registry component updates
uishelf installed            # List all installed components and integrity hashes
uishelf diff <component>     # Preview changes against current local files
uishelf doctor               # Run comprehensive stack, dependency & provider health check
uishelf providers list       # List all active and discovered providers
uishelf providers sync       # Synchronize with official shadcn registry index
uishelf providers add        # Add a custom enterprise or community registry
uishelf auth login <id>      # Authenticate with an authenticated provider
uishelf config               # View or configure provider allowlist, min-score, etc.
uishelf cache clear          # Purge local registry cache
uishelf mcp                  # Start Model Context Protocol server (stdio mode)

🤖 Model Context Protocol (MCP) Setup

Add UIShelf to your claude_desktop_config.json, Cursor, or Antigravity MCP settings:

{
  "mcpServers": {
    "uishelf": {
      "command": "npx",
      "args": ["-y", "uishelf", "mcp"]
    }
  }
}

Exposed MCP Tools:

search_components: Hybrid discovery with stack context
inspect_component: Inspect code, score breakdown, and prerequisites
compare_components: Side-by-side component or provider comparison
detect_project: Full project stack diagnostic
get_install_plan: Non-destructive install plan calculation
install_component: Transactional installation with confirmation
doctor: Project and provider health diagnostics

📦 Modular Packages on NPM

All packages are published under the @uishelf scope and the main uishelf CLI on the npm registry:

Package	Version	Description
`uishelf`	`0.1.0`	Production CLI, terminal UX, and stdio MCP command
`@uishelf/core`	`0.1.0`	Central orchestration engine uniting all packages
`@uishelf/schema`	`0.1.0`	Canonical Zod schemas & TypeScript definitions
`@uishelf/project`	`0.1.0`	React 18/19, Next.js 14/15, Tailwind v3/v4 detector
`@uishelf/search`	`0.1.0`	Zero-API-key BM25 + fuzzy hybrid search engine
`@uishelf/resolver`	`0.1.0`	Dependency resolution & multi-variant routing engine
`@uishelf/ranking`	`0.1.0`	9-factor transparent scoring algorithm
`@uishelf/registry`	`0.1.0`	Official shadcn registry synchronizer & seed catalog
`@uishelf/providers`	`0.1.0`	Pluggable provider system (shadcn, 21st, Ruixen, etc.)
`@uishelf/installer`	`0.1.0`	Transactional planner with backup & rollback safety
`@uishelf/security`	`0.1.0`	Path traversal guard & AST safety validator
`@uishelf/credentials`	`0.1.0`	Secret store with on-demand auth & redaction
`@uishelf/config`	`0.1.0`	Hierarchical configuration manager (`uishelf.json`)
`@uishelf/cache`	`0.1.0`	Fast filesystem & memory caching with offline support
`@uishelf/mcp`	`0.1.0`	Stdio Model Context Protocol (MCP) server

🤝 Contributing & Community

We warmly welcome community contributions, provider adapters, bug fixes, and feature proposals!

📖 Read our Contributing Guide to set up your local development environment.
📜 Review our Code of Conduct for community standards.
💡 Have an idea for a new UI Provider? Request a Provider or open a PR.
💬 Join the conversation on GitHub Discussions.

🛡️ Security

Security and code safety are top priorities. Please review our Security Policy to report vulnerabilities privately or learn about our static AST safety checks.

📄 License

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

marmo-ui A
io.github.mahmoudilyan
Live React design-system APIs, patterns, and code validation so AI agents build real UI, not slop.
Design Tools Developer Tools
142
21st.dev AOAuth
dev.21st
Find UI components and themes, retrieve code, and generate with hosted 21st AI when enabled.
Design Tools Developer Tools AI & Machine Learning
2
Package Intel MCP A
io.github.selflabbs
Package intelligence for AI agents across npm, PyPI, crates.io and deps.dev. No API keys.
Developer Tools Code Analysis
2
Package Intel MCP A
com.datakoot
Package intelligence for AI agents across npm, PyPI, crates.io and deps.dev. No API keys.
Developer Tools Code Analysis
61

Related MCP Servers

Ruixen MCP Serverofficial
Developer Tools Search
ruixenui
A
license
B
quality
D
maintenance
Enables AI assistants to discover, search, and retrieve Ruixen UI components from the live registry, providing installation commands for MCP-compatible clients.
Updated 5 months ago (2026-04-21 16:17 UTC)
3
8 npm
1
MIT
ui-registry-mcp
Developer Tools Coding Agents
mrityunjay-tiwari
A
license
A
quality
B
maintenance
Provides coding agents live access to shadcn-style component registries, enabling them to search, compare, and fetch real component source code for UI composition.
Updated 2 months ago (2026-07-13 09:29 UTC)
5
61 npm
5
MIT
animai
Developer Tools Coding Agents
Hajjy22
A
license
Not graded
quality
B
maintenance
Enables AI agents to search for and fetch pre-vetted, production-safe 3D and motion components (React Three Fiber & GSAP) for injection into Next.js apps via AST-safe edits.
Updated 2 months ago (2026-07-16 11:11 UTC)
114 npm
MIT
CRUX MCP Server
Developer Tools Code Execution Code Analysis
JustineDevs
A
license
Not graded
quality
C
maintenance
Federates UI component registries, enabling AI agents to fetch exact component code, dependencies, and setup prerequisites directly into the workspace. Includes sandboxed previews, anti-slop layout auditing, and offline-to-cloud telemetry sync.
Updated a month ago (2026-08-14 07:50 UTC)
5 npm
1
MIT