shadcn-ui-mcp-server
A mcp server to allow LLMS gain context about shadcn ui component structure,usage and installation,compaitable with react,svelte 5,vue & React Native
Top Related Projects
A set of beautifully-designed, accessible components and a code distribution platform. Works with your favorite frameworks. Open Source. Open Code.
Radix Primitives is an open-source UI component library for building high-quality, accessible design systems and web apps. Maintained by @workos.
A utility-first CSS framework for rapid UI development.
Chakra UI is a component system for building SaaS products with speed ⚡️
Material UI: Comprehensive React component library that implements Google's Material Design. Free forever.
daisyUI components built with React 🌼
Quick Overview
Jpisnice/shadcn-ui-mcp-server is a GitHub repository that appears to be a server-side implementation or adaptation of the shadcn/ui component library for use with MCP (Minecraft Control Panel) servers. It likely provides server-side rendering or integration of shadcn/ui components within a Minecraft server management context.
Pros
- Combines the modern UI components of shadcn/ui with Minecraft server management
- Potentially improves the user interface for Minecraft server administrators
- May offer a more streamlined and visually appealing MCP experience
- Could enhance the overall usability of Minecraft server control panels
Cons
- Limited information available about the project's specific features and implementation
- May have a narrow use case, primarily targeting Minecraft server administrators
- Potential compatibility issues with different Minecraft server versions or plugins
- Possibly in early development stages, which could mean limited documentation or support
Code Examples
As this repository does not provide public code samples or a clear indication of being a code library, we cannot provide specific code examples.
Getting Started
Since this project appears to be a server-side implementation rather than a code library, and there are no clear instructions provided in the repository, we cannot offer specific getting started instructions.
Competitor Comparisons
A set of beautifully-designed, accessible components and a code distribution platform. Works with your favorite frameworks. Open Source. Open Code.
Pros of shadcn-ui
- More comprehensive UI component library with a wider range of components
- Better documentation and examples for each component
- Larger community and more frequent updates
Cons of shadcn-ui
- Potentially more complex setup and configuration
- May include unnecessary components for smaller projects
- Steeper learning curve for beginners
Code Comparison
shadcn-ui:
import { Button } from "@/components/ui/button"
export function ButtonDemo() {
return <Button>Click me</Button>
}
shadcn-ui-mcp-server:
import { Button } from "shadcn-ui-mcp-server"
export function ButtonDemo() {
return <Button>Click me</Button>
}
The code usage is similar, but shadcn-ui typically requires more setup and configuration in the project structure. shadcn-ui-mcp-server aims for a simpler integration, potentially at the cost of customization options.
shadcn-ui offers a more extensive set of components and customization options, making it suitable for larger projects with diverse UI needs. However, this comes with increased complexity and potential overhead.
shadcn-ui-mcp-server, on the other hand, appears to be a more streamlined version, possibly focusing on core components and easier integration. This could be beneficial for smaller projects or developers looking for a quicker setup process.
Radix Primitives is an open-source UI component library for building high-quality, accessible design systems and web apps. Maintained by @workos.
Pros of radix-ui/primitives
- More comprehensive set of UI components and primitives
- Better accessibility features and compliance with ARIA standards
- Larger community and more frequent updates
Cons of radix-ui/primitives
- Steeper learning curve due to its extensive API
- Requires more setup and configuration compared to shadcn-ui-mcp-server
- May be overkill for smaller projects or simpler UI requirements
Code Comparison
shadcn-ui-mcp-server:
import { Button } from "@/components/ui/button"
export default function Home() {
return <Button>Click me</Button>
}
radix-ui/primitives:
import * as Button from '@radix-ui/react-button';
export default function Home() {
return (
<Button.Root>
<Button.Text>Click me</Button.Text>
</Button.Root>
);
}
The code comparison shows that shadcn-ui-mcp-server offers a simpler, more straightforward implementation of UI components. In contrast, radix-ui/primitives provides a more granular approach with separate components for different parts of the button, allowing for greater customization but requiring more code.
A utility-first CSS framework for rapid UI development.
Pros of tailwindcss
- Larger community and more extensive documentation
- More comprehensive utility-first CSS framework
- Widely adopted in production environments
Cons of tailwindcss
- Steeper learning curve for developers new to utility-first CSS
- Can lead to verbose class names in HTML
Code Comparison
tailwindcss:
<div class="flex items-center justify-between p-4 bg-blue-500 text-white">
<h1 class="text-2xl font-bold">Header</h1>
<button class="px-4 py-2 bg-white text-blue-500 rounded">Click me</button>
</div>
shadcn-ui-mcp-server:
<Card>
<CardHeader>
<CardTitle>Header</CardTitle>
</CardHeader>
<CardContent>
<Button>Click me</Button>
</CardContent>
</Card>
The tailwindcss example shows inline utility classes, while shadcn-ui-mcp-server uses pre-built components with abstracted styling.
Chakra UI is a component system for building SaaS products with speed ⚡️
Pros of chakra-ui
- More mature and widely adopted project with a larger community
- Comprehensive documentation and extensive component library
- Built-in support for responsive design and theming
Cons of chakra-ui
- Larger bundle size due to its extensive feature set
- Steeper learning curve for beginners compared to simpler UI libraries
- Less flexibility for custom styling without overriding default themes
Code Comparison
chakra-ui:
import { Box, Button, Text } from '@chakra-ui/react'
function Example() {
return (
<Box>
<Text>Hello, Chakra UI!</Text>
<Button colorScheme="blue">Click me</Button>
</Box>
)
}
shadcn-ui-mcp-server:
import { Button } from "@/components/ui/button"
function Example() {
return (
<div>
<p>Hello, shadcn-ui!</p>
<Button variant="default">Click me</Button>
</div>
)
}
The code comparison shows that both libraries offer similar component-based structures, but chakra-ui provides more built-in styling options and a more extensive component set out of the box. shadcn-ui-mcp-server appears to have a simpler API and relies more on custom styling.
Material UI: Comprehensive React component library that implements Google's Material Design. Free forever.
Pros of Material-UI
- Extensive component library with a wide range of pre-built UI elements
- Strong community support and regular updates
- Comprehensive documentation and examples
Cons of Material-UI
- Larger bundle size due to the extensive component library
- Steeper learning curve for customization and theming
- More opinionated design system, which may limit flexibility
Code Comparison
Material-UI:
import { Button, TextField } from '@mui/material';
<Button variant="contained" color="primary">
Click me
</Button>
<TextField label="Enter text" variant="outlined" />
shadcn-ui-mcp-server:
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
<Button>Click me</Button>
<Input placeholder="Enter text" />
The Material-UI code shows more built-in variants and properties, while shadcn-ui-mcp-server offers a simpler, more minimalistic approach. Material-UI provides more out-of-the-box styling options, but shadcn-ui-mcp-server allows for easier customization with less predefined styles.
daisyUI components built with React 🌼
Pros of react-daisyui
- More comprehensive component library with a wider range of pre-built UI elements
- Better documentation and examples for each component
- Active community support and regular updates
Cons of react-daisyui
- Larger bundle size due to the extensive component library
- Less flexibility in customizing individual components
- Steeper learning curve for developers new to the library
Code Comparison
react-daisyui:
import { Button } from 'react-daisyui'
function MyComponent() {
return <Button color="primary">Click me</Button>
}
shadcn-ui-mcp-server:
import { Button } from '@/components/ui/button'
function MyComponent() {
return <Button variant="default">Click me</Button>
}
The code comparison shows that both libraries offer similar component usage, but react-daisyui uses a color prop for styling, while shadcn-ui-mcp-server uses a variant prop. This reflects the different approaches to component customization between the two libraries.
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
Shadcn UI v4 MCP Server
ð The fastest way to integrate shadcn/ui components into your AI workflow
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to shadcn/ui v4 components, blocks, demos, and metadata. Seamlessly retrieve React, Svelte, Vue, and React Native implementations for your AI-powered development workflow.
⨠Key Features
- ð¯ Multi-Framework Support - React, Svelte, Vue, and React Native implementations
- ð¦ Component Source Code - Latest shadcn/ui v4 TypeScript source
- ð¨ Component Demos - Example implementations and usage patterns
- ðï¸ Blocks Support - Complete block implementations (dashboards, calendars, forms)
- ð Metadata Access - Dependencies, descriptions, and configuration details
- ð Directory Browsing - Explore repository structures
- â¡ Smart Caching - Efficient GitHub API integration with rate limit handling
- ð SSE Transport - Server-Sent Events support for multi-client deployments
- ð³ Docker Ready - Production-ready containerization with Docker Compose
ð Quick Start
# Basic usage (60 requests/hour)
npx @jpisnice/shadcn-ui-mcp-server
# With GitHub token (5000 requests/hour) - Recommended
npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here
# Switch frameworks
npx @jpisnice/shadcn-ui-mcp-server --framework svelte
npx @jpisnice/shadcn-ui-mcp-server --framework vue
npx @jpisnice/shadcn-ui-mcp-server --framework react-native
ð¯ Get your GitHub token in 2 minutes: docs/getting-started/github-token.md
ð¦ One-Click Installation (Claude Desktop)
Download and double-click the .mcpb file for instant installation:
- Download
shadcn-ui-mcp-server.mcpbfrom Releases - Double-click the file - Claude Desktop opens automatically
- Enter your GitHub token (optional, for higher rate limits)
- Click Install - tools are available immediately
Manual install: Claude Desktop â Settings â MCP â Add Server â Browse â Select .mcpb file
References: Anthropic Desktop Extensions | Building MCPB
ð SSE Transport & Docker Deployment
Run the server with Server-Sent Events (SSE) transport for multi-client support and production deployments:
Quick Start with SSE
# SSE mode (supports multiple concurrent connections)
node build/index.js --mode sse --port 7423
# Docker Compose (production ready)
docker-compose up -d
# Connect with Claude Code
claude mcp add --scope user --transport sse shadcn-mcp-server http://localhost:7423/sse
Transport Modes
stdio(default) - Standard input/output for CLI usagesse- Server-Sent Events for HTTP-based connectionsdual- Both stdio and SSE simultaneously
Docker Examples
# Basic container
docker run -p 7423:7423 shadcn-ui-mcp-server
# With GitHub API token
docker run -p 7423:7423 -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token shadcn-ui-mcp-server
# Docker Compose (recommended)
docker-compose up -d
curl http://localhost:7423/health
Environment Variables
MCP_TRANSPORT_MODE- Transport mode (stdio|sse|dual)MCP_PORT- SSE server port (default: 7423 - SHADCN on keypad!)MCP_HOST- Host binding (default: 0.0.0.0)MCP_CORS_ORIGINS- CORS origins (comma-separated)GITHUB_PERSONAL_ACCESS_TOKEN- GitHub API token
ð Documentation
| Section | Description |
|---|---|
| ð Getting Started | Installation, setup, and first steps |
| âï¸ Configuration | Framework selection, tokens, and options |
| ð Integration | Editor and tool integrations |
| ð Usage | Examples, tutorials, and use cases |
| ð¨ Frameworks | Framework-specific documentation |
| ð Troubleshooting | Common issues and solutions |
| ð§ API Reference | Tool reference and technical details |
ð¨ Framework Support
This MCP server supports four popular shadcn implementations:
| Framework | Repository | Maintainer | Description |
|---|---|---|---|
| React (default) | shadcn/ui | shadcn | React components from shadcn/ui v4 |
| Svelte | shadcn-svelte | huntabyte | Svelte components from shadcn-svelte |
| Vue | shadcn-vue | unovue | Vue components from shadcn-vue |
| React Native | react-native-reusables | Founded Labs | React Native components from react-native-reusables |
ð ï¸ Essential Setup
1. Get GitHub Token (Recommended)
# Visit: https://github.com/settings/tokens
# Generate token with no scopes needed
export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_token_here
2. Run Server
# React (default)
npx @jpisnice/shadcn-ui-mcp-server
# Svelte
npx @jpisnice/shadcn-ui-mcp-server --framework svelte
# Vue
npx @jpisnice/shadcn-ui-mcp-server --framework vue
# React Native
npx @jpisnice/shadcn-ui-mcp-server --framework react-native
3. Integrate with Your Editor
- Claude Code: See Claude Code Integration below
- VS Code: docs/integration/vscode.md
- Cursor: docs/integration/cursor.md
- Claude Desktop: docs/integration/claude-desktop.md
- Continue.dev: docs/integration/continue.md
ð» Claude Code Integration
Quick Add (CLI)
# Add the shadcn-ui MCP server
claude mcp add shadcn -- bunx -y @jpisnice/shadcn-ui-mcp-server --github-api-key YOUR_TOKEN
SSE Transport
For production deployments with SSE transport:
# Start server in SSE mode
node build/index.js --mode sse --port 7423
# Connect with Claude Code
claude mcp add --scope user --transport sse shadcn-mcp-server http://localhost:7423/sse
Framework-Specific Commands
See Claude Code Integration Guide for framework-specific commands (React, Svelte, Vue, React Native).
Reference: Claude Code MCP Documentation
ð¯ Use Cases
- AI-Powered Development - Let AI assistants build UIs with shadcn/ui
- Multi-Client Deployments - SSE transport supports multiple concurrent connections
- Production Environments - Docker Compose ready with health checks and monitoring
- Component Discovery - Explore available components and their usage
- Multi-Framework Learning - Compare React, Svelte, Vue, and React Native implementations
- Rapid Prototyping - Get complete block implementations for dashboards, forms, etc.
- Code Generation - Generate component code with proper dependencies
ð¦ Installation
# Global installation (optional)
npm install -g @jpisnice/shadcn-ui-mcp-server
# Or use npx (recommended)
npx @jpisnice/shadcn-ui-mcp-server
ð¨ Building from Source
Prerequisites
- Node.js >= 18.0.0
- npm or pnpm
Build Steps
# Clone the repository
git clone https://github.com/Jpisnice/shadcn-ui-mcp-server.git
cd shadcn-ui-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
node build/index.js --github-api-key YOUR_TOKEN
Run Locally
# After building, run with options
node build/index.js --github-api-key YOUR_TOKEN
node build/index.js --framework svelte
Building MCPB Package
The project includes a manifest.json following the MCPB specification. The .mcpb file is a ZIP archive containing the server, dependencies, and configuration.
See CONTRIBUTING.md for detailed packaging instructions.
Reference: Building Desktop Extensions with MCPB
ð Quick Links
- ð Full Documentation
- ð Getting Started Guide
- ð SSE Transport & Docker Guide
- ð¨ Framework Comparison
- ð§ API Reference
- ð Troubleshooting
- ð¬ Issues & Discussions
ð License
MIT License - see LICENSE for details.
ð Acknowledgments
- shadcn - For the amazing React UI component library
- huntabyte - For the excellent Svelte implementation
- unovue - For the comprehensive Vue implementation
- Founded Labs - For the React Native implementation
- Anthropic - For the Model Context Protocol specification
Made with â¤ï¸ by Janardhan Polle
Star â this repo if you find it helpful!
Top Related Projects
A set of beautifully-designed, accessible components and a code distribution platform. Works with your favorite frameworks. Open Source. Open Code.
Radix Primitives is an open-source UI component library for building high-quality, accessible design systems and web apps. Maintained by @workos.
A utility-first CSS framework for rapid UI development.
Chakra UI is a component system for building SaaS products with speed ⚡️
Material UI: Comprehensive React component library that implements Google's Material Design. Free forever.
daisyUI components built with React 🌼
Convert
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot