# Jpisnice/shadcn-ui-mcp-server [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Jpisnice/shadcn-ui-mcp-server  
**GitHub Stars:** 3072  
**npm Downloads (last month):** 11568  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jpisnice-shadcn-ui-mcp-server

## Description
MCP server that gives AI assistants seamless access to shadcn/ui v4 components, blocks, demos, and metadata.

## Tools
Capabilities this server exposes over MCP:

- **get_component** — Get the source code for a specific shadcn/ui v4 component
- **get_component_demo** — Get demo code illustrating how a shadcn/ui v4 component should be used
- **list_components** — Get all available shadcn/ui v4 components
- **get_component_metadata** — Get metadata for a specific shadcn/ui v4 component
- **get_directory_structure** — Get the directory structure of the shadcn-ui v4 repository
- **get_block** — Get source code for a specific shadcn/ui v4 block (e.g., calendar-01, dashboard-01)
- **list_blocks** — Get all available shadcn/ui v4 blocks with categorization
- **apply_theme** — Apply a TweakCN theme preset to the project
- **list_themes** — List available tweakcn themes
- **get_theme** — Get details of a specific tweakcn theme

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "shadcn-ui-mcp-server": {
    "command": "npx",
    "args": ["-y","@jpisnice/shadcn-ui-mcp-server"],
    "env": {
      "MCP_TRANSPORT_MODE": "",
      "MCP_PORT": "",
      "MCP_HOST": "",
      "MCP_CORS_ORIGINS": "",
      "GITHUB_PERSONAL_ACCESS_TOKEN": "",
      "UI_LIBRARY": ""
    }
  }
}
```

**Requires environment variables:** `MCP_TRANSPORT_MODE`, `MCP_PORT`, `MCP_HOST`, `MCP_CORS_ORIGINS`, `GITHUB_PERSONAL_ACCESS_TOKEN`, `UI_LIBRARY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Jpisnice/shadcn-ui-mcp-server does

It covers the React shadcn/ui v4 implementation by default, along with Svelte, Vue, and React Native variants. For React, the server can use either Radix UI or Base UI primitives, with Radix as the default.

The available content includes component source code, demos, blocks, dependency information, descriptions, configuration details, and directory listings. Blocks include larger examples such as dashboards, calendars, and forms. This makes the server suitable for agents that need to inspect existing implementations before producing UI code or explaining how a component is structured.

## How it works

The server integrates with GitHub to retrieve repository content. Caching is used to reduce repeated GitHub requests and handle rate-limit conditions.

Standard input/output is the default transport for local command-line use. SSE mode exposes the server through an HTTP endpoint and is intended for multiple concurrent connections. A dual mode can run both stdio and SSE. Docker and Docker Compose examples are provided for deployments that need a containerized SSE service, including a health endpoint on the documented port.

Framework and UI-library choices can be supplied as command-line options or environment variables. The supported framework values are React, Svelte, Vue, and React Native. The Base UI option applies only to React.

## Setup and configuration

Run Jpisnice/shadcn-ui-mcp-server MCP server with Node.js 18 or newer using the published npm package and npx. A GitHub personal access token is optional, but recommended when the client will make enough requests to exceed the unauthenticated limit.

The documented environment variables control transport mode, port, host binding, CORS origins, GitHub authentication, and the React primitive library. The default SSE port is 7423, while the default transport is stdio. For a source build, install dependencies, run the project build script, and start the generated `build/index.js` entry point.

Claude Desktop can be configured through a downloadable `.mcpb` release file or through its MCP settings.

## Tools and capabilities

- Retrieve component source implementations.
- Inspect component demos and usage patterns.
- Browse blocks such as dashboards, calendars, and forms.
- Read dependencies, descriptions, and configuration metadata.
- Browse relevant repository directories.
- Select React, Svelte, Vue, or React Native content.
- Select Radix UI or Base UI for React.
- Serve clients over stdio, SSE, or both.

## Limitations and notes

Jpisnice/shadcn-ui-mcp-server MCP server depends on GitHub access for its repository data, so request limits matter for repeated or broad exploration. Authentication is not mandatory, but unauthenticated use has the lower documented request allowance.

SSE deployment requires starting the built server or using the supplied Docker examples; the npm command defaults to stdio. The material identifies Claude Desktop, Claude Code, Cursor, VS Code, and Continue.dev integration guidance, but it does not establish compatibility with every MCP client. The repository is MIT-licensed.

_Full upstream README: https://allmcps.com/mcp/jpisnice-shadcn-ui-mcp-server/readme_