shadcn mcp - shadcn/ui

The mcp command starts the shadcn MCP server or helps you configure MCP clients.

Usage

Start the MCP server:

npx shadcn@latest mcp

Initialize MCP for a specific client:

npx shadcn@latest mcp init --client <client-name>

Options

string

The MCP client to configure. Available options:

claude - Claude Code
cursor - Cursor
vscode - VS Code
codex - Codex
opencode - OpenCode

string

The working directory. Defaults to the current directory.

Examples

Start MCP server

npx shadcn@latest mcp

This command starts the MCP server that AI assistants can connect to for browsing and installing components.

Initialize for Claude Code

npx shadcn@latest mcp init --client claude

Creates .mcp.json with configuration for Claude Code.

Initialize for Cursor

npx shadcn@latest mcp init --client cursor

Creates .cursor/mcp.json with configuration for Cursor.

Initialize for VS Code

npx shadcn@latest mcp init --client vscode

Creates .vscode/mcp.json with configuration for VS Code with GitHub Copilot.

What it does

When you run mcp init:

Detects configuration - Checks for existing MCP configuration
Creates config file - Adds shadcn MCP server configuration
Installs dependencies - Optionally installs shadcn package
Provides instructions - Shows next steps for your specific client

When you run mcp without arguments:

Starts MCP server - Launches the Model Context Protocol server
Loads registries - Reads component registries from components.json
Exposes tools - Makes browsing, searching, and installation tools available to AI assistants

Configuration

The MCP server reads registry configuration from components.json:

components.json

{
  "registries": {
    "@acme": "https://acme.com/r/{name}.json"
  }
}

Learn more

MCP Integration Guide - Complete guide to using MCP with shadcn/ui
Registry Documentation - Learn about component registries
Model Context Protocol - Official MCP specification

⌘I

​Usage

​Options

​Examples

​Start MCP server

​Initialize for Claude Code

​Initialize for Cursor

​Initialize for VS Code

​What it does

​Configuration

​Learn more