Shadcn Registry Mcp Server
@reuvenaor
MCP server for the shadcn/ui component registry and CLI. It enables remote, programmatic, or containerized execution of shadcn CLI commands (such as init, add, etc.) that you would normally run locally, making it easy to automate, integrate, or run in cloud/dev environments.
概要
What is Shadcn Registry Mcp Server?
Shadcn Registry Mcp Server is an MCP (Model Context Protocol) server for the shadcn/ui component registry and CLI. It enables remote, programmatic, or containerized execution of shadcn CLI commands (such as init, add, etc.) that you would normally run locally, making it easy to automate, integrate, or run these commands in cloud or development environments. The server supports connecting to both the official shadcn registry and custom/self-hosted registries, providing a technical interface for AI agents or CLI tools.
How to use Shadcn Registry Mcp Server?
Add the server to your mcp.json configuration. You can run it via Docker (mounting your project directory and setting REGISTRY_URL, STYLE environment variables) or via npx (setting REGISTRY_URL, WORKSPACE_DIR, and STYLE). The server exposes a set of MCP tools such as get_init_instructions, execute_init, get_items, add_item, execute_add, and get_blocks that you or an AI agent can call to manage shadcn components.
Key features of Shadcn Registry Mcp Server
- Exposes shadcn CLI operations as MCP tools.
- Supports project initialization and component addition.
- Can fetch, list, and add registry items including block components.
- Works with both official and custom/self-hosted registries.
- Deployable via Docker or npx.
- Integrates with AI agents and Claude.
Use cases of Shadcn Registry Mcp Server
- Automate shadcn project initialization in CI/CD pipelines.
- Programmatically add components to projects via AI assistants.
- Manage multiple projects using a central or containerized registry interface.
- Run shadcn CLI workflows in cloud or remote development environments.
FAQ from Shadcn Registry Mcp Server
What tools does Shadcn Registry Mcp Server provide?
It provides tools including get_init_instructions, execute_init, get_items, get_item, add_item, execute_add, and get_blocks.
How do I configure a custom registry URL?
Set the REGISTRY_URL environment variable to the URL of your custom shadcn registry (e.g., http://localhost:3000/r), following the guide at https://ui.shadcn.com/docs/blocks.
What runtime dependencies are required?
You need either Docker (for containerized deployment) or Node.js (for npx usage). The server runs as a standalone process using the
