shadcn-ui MCP Server
MCP server for shadcn/ui component references
This is a TypeScript-based MCP server that provides reference information for shadcn/ui components. It implements a Model Context Protocol (MCP) server that helps AI assistants access shadcn/ui component documentation and examples.
Features
Tools
list_shadcn_components
- Get a list of all available shadcn/ui componentsget_component_details
- Get detailed information about a specific componentget_component_examples
- Get usage examples for a specific componentsearch_components
- Search for components by keyword
Functionality
This server scrapes and caches information from:
- The official shadcn/ui documentation site (https://ui.shadcn.com)
- The shadcn/ui GitHub repository
It provides structured data including:
- Component descriptions
- Installation instructions
- Usage examples
- Props and variants
- Code samples
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Installation
Claude Desktop Configuration
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Option 1: Using local build
{
"mcpServers": {
"shadcn-ui-server": {
"command": "/path/to/shadcn-ui-server/build/index.js"
}
}
}
Option 2: Using npx command
{
"mcpServers": {
"shadcn-ui-server": {
"command": "npx",
"args": ["-y", "shadcn-ui-mcp-server"]
}
}
}
Windsurf Configuration
Add this to your ./codeium/windsurf/model_config.json
:
{
"mcpServers": {
"shadcn-ui-server": {
"command": "npx",
"args": ["-y", "shadcn-ui-mcp-server"]
}
}
}
Cursor Configuration
Add this to your .cursor/mcp.json
:
{
"mcpServers": {
"shadcn-ui-server": {
"command": "npx",
"args": ["-y", "shadcn-ui-mcp-server"]
}
}
}
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
shadcn-ui MCP Server
Project Details
- ymadd/shadcn-ui-mcp-server
- shadcn-ui-mcp-server
- MIT License
- Last Updated: 4/18/2025
Recomended MCP Servers
MCP Server for Trino
MCP (Model Context Protocol) for Microsoft 365. Includes support for Microsoft Graph and other services
Configurable Puppeteer MCP Server
openai websearch tool as mcp server
MCP server that provide tools to LLMs such as claude in cursor to interact with MongoDB
This repository is for development of the Azure MCP Server, bringing the power of Azure to your agents.
MCP server to interact with Redis Server, AWS Memory DB, etc for caching or other use-cases where in-memory...
Ragie Model Context Protocol Server
Airtable Model Context Protocol Server, for allowing AI systems to interact with your Airtable bases
Cryptocurrency Market Data MCP Server