Ruixen MCP Server
OfficialClick 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., "@Ruixen MCP Server Show me button components with spring animations"
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.
@ruixen/mcp
Official Model Context Protocol server for Ruixen UI.
The server reads directly from the live Ruixen registry, so the components your AI assistant can reach are always in sync with what's on ruixen.com.
Installation
Add to your IDE's MCP config:
{
"mcpServers": {
"ruixen-mcp": {
"command": "npx",
"args": ["-y", "@ruixen/mcp@latest"]
}
}
}Works with any MCP-compatible client — Cursor, Claude Desktop, Windsurf, Cline, Roo-Cline, and VS Code (with an MCP extension). Each client stores this config in its own settings file; consult your client's docs for the exact location.
Related MCP server: aceternityui-mcp
Example Usage
Once configured, ask your AI assistant things like:
"Make a marquee of logos"
"Add a blur fade text animation"
"Add a grid background"
"Show me button components with spring animations"
The assistant calls the MCP tools below to discover components, pull their source, and hand you the exact npx shadcn@latest add … command to install each one into your project.
Available Tools
Tool | Description |
| List registry items with optional |
| Keyword search across names, titles, descriptions, and registry types, ranked by relevance. Good when you know roughly what you want. |
| Item detail for a specific component. Optionally includes |
Development
npm install
npm run build # tsc + chmod
npm test # runs the live-registry smoke test (requires internet)License
Available Tools
3 toolsgetRegistryItemB
Gets detailed information for a single Ruixen UI registry item.
Inputs: name (required), includeSource, includeExamples, includeRelated.
listRegistryItemsC
Lists Ruixen UI registry items with optional filtering by kind, query, and limit.
Inputs: kind, query, limit, offset.
searchRegistryItemsB
Searches Ruixen UI registry items by keyword or use case.
Inputs: query (required), kind, limit, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct operation: retrieving a single item, listing with filters, and searching. There is no overlap in purpose.
Tool names follow a verb_Noun pattern in camelCase, though getRegistryItem uses singular RegistryItem while the others use plural RegistryItems, a minor inconsistency.
Three tools cover the core retrieval and search operations for a registry. The count is reasonable, though slightly low if full CRUD were expected.
The set covers reading, listing, and searching items but lacks create, update, or delete operations. This may be intentional for a read-only registry, but it's a notable gap.
Maintenance
Related MCP Connectors
Search, read and install agent-ready React components, screens and blocks for AI products.
Find UI components and themes, retrieve code, and generate with hosted 21st AI when enabled.
Search and install PixilUI React components for AI product UI into your app.
Search a directory of 70K+ AI building blocks: MCP servers, agents, models, datasets, prompts.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides a foundation for building MCP servers that expose UI component registries to AI assistants, enabling component discovery and retrieval.12MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to search, discover, and install Aceternity UI components programmatically.5114 npm27MIT
- AlicenseAqualityDmaintenanceProvides coding agents live access to shadcn-style component registries, enabling them to search, compare, and fetch real component source code for UI composition.572 npm6MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to search, discover, and retrieve UI HUB components, source code, dependencies, templates, and animations via MCP.-