$ timeahead.in
/ servers/npm/shadcn-ui-mcp-server
npm

shadcn-ui-mcp-server

MCP server for shadcn/ui component references

60 stars3k/wkupdated 448d agogithub ↗
87good
▣ Overview

What it does

This MCP server provides structured access to shadcn/ui component documentation by scraping the official reference site and GitHub repository to create a cached reference database. It exposes tools to list all available components, retrieve detailed information including descriptions, installation instructions, and component props, fetch usage examples and code samples, and search components by keyword or functionality. Component data is cached to reduce redundant fetches from external sources, enabling rapid lookups during development.

Who it's for

Frontend developers building React applications with shadcn/ui components in TypeScript projects. Also useful for AI assistants (Claude via Claude Desktop, Windsurf, or Cursor) that need to reference component APIs, configuration options, and usage patterns during real-time code generation or when answering questions about component implementation.

Common use cases

  • Query shadcn/ui component documentation without leaving your editor
  • Fetch installation and usage examples while building UI code
  • Search for components by functionality or name
  • Reference component props, variants, and configuration patterns during development

Setup pitfalls

  • Last commit was 410 days ago—component references may be stale as shadcn/ui evolves
  • Relies on scraping the official documentation site; breaks if the site structure changes
  • Requires network connectivity to fetch component data
  • Use npx -y shadcn-ui-mcp-server with the -y flag to auto-confirm package installation
▣ Score BreakdownMCPScore = Σ(raw × weight)
DimensionRawWeighted
Security
35%
100
35.0
Freshness
25%
100
25.0
Adoption
20%
59
11.8
Quality
10%
100
10.0
Trust
10%
50
5.0
Total
86.8
⚿ Capabilities & Risk Explainer
network
◆ Risk level: medium
network are active.
⚙ Install config
Claude Desktop · Cursor · Windsurf · VS Code (Copilot) · Claude Code
add to your MCP client config:
{
  "mcpServers": {
    "shadcn-ui": {
      "command": "npx",
      "args": [
        "-y",
        "shadcn-ui-mcp-server"
      ]
    }
  }
}
⚙ Maintenance health
12/ 100 · is this project alive?
contributors (1y)0
top contributor share0%
releases (1y)0
ci✗ none
⛁ Raw data
weekly downloads3k
github stars60
forks9
open issues2
license✓ present
readme length2437 chars
last publish7d ago
last commit448d ago
last updated1d ago
install verified✓ pass · 53d ago
owner of this server? claim your listing to get a verified badgeclaim →
🔔 Score drop alerts
get notified by email when this server's score drops 5+ points