convez.ai
MCP ServerDesenvolvimento WebIntermediário
heilgar

Shadcn UI MCP Server

heilgar/shadcn-ui-mcp-server

Gerenciador de componentes Shadcn UI via MCP para IDEs e Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP especializado em gerenciar componentes e blocos do Shadcn UI. Fornece ferramentas para listar, obter documentação e instalar componentes com suporte a múltiplos package managers (npm, pnpm, yarn, bun). Integra-se nativamente com Claude Desktop, Windsurf e Cursor.

Instalação

$npx convez-ai heilgar/shadcn-ui-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
26
Forks
10
Acompanhando
1
Saúde
28%
Último commit
há 1 ano
Versão
—
Issues abertas
0
Contribuidores
4

Casos de uso

  • Instalar e gerenciar componentes Shadcn UI dentro de projetos TypeScript
  • Consultar documentação de componentes UI enquanto desenvolve
  • Automatizar setup de blocos de UI em aplicações React

Veredito

MCP server bem estruturado para integração do Shadcn UI em fluxos de desenvolvimento com Claude e outros editores. Reduz fricção na descoberta e instalação de componentes, mas valor agregado depende de já usar Shadcn UI na stack.

README

A tradução para o português deste README ainda está na fila.

Shadcn UI MCP Server

A powerful and flexible MCP (Model Control Protocol) server designed to enhance the development experience with Shadcn UI components. This server provides a robust foundation for building and managing UI components with advanced tooling and functionality.

Features

Tools

The MCP server provides a set of tools that can be used through the Model Control Protocol:

  • list-components: Get the list of available shadcn/ui components
  • get-component-docs: Get documentation for a specific component
  • install-component: Install a shadcn/ui component
  • list-blocks: Get the list of available shadcn/ui blocks
  • get-block-docs: Get documentation for a specific block
  • install-blocks: Install a shadcn/ui block

Functionality

  • Component Management

    • List available shadcn/ui components
    • Get detailed documentation for specific components
    • Install components with support for multiple package managers (npm, pnpm, yarn, bun)
  • Block Management

    • List available shadcn/ui blocks
    • Get documentation and code for specific blocks
    • Install blocks with support for multiple package managers
  • Package Manager Support

    • Flexible runtime support for npm, pnpm, yarn, and bun
    • Automatic detection of user's preferred package manager

Installation

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn package manager

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

{
  "mcpServers": {
    "shadcn-ui-server": {
      "command": "npx",
      "args": ["@heilgar/shadcn-ui-mcp-server"]
    }
  }
}

Windsurf Configuration

Add this to your ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "shadcn-ui-server": {
      "command": "npx",
      "args": ["@heilgar/shadcn-ui-mcp-server"]
    }
  }
}

Cursor Configuration

Add this to your .cursor/mcp.json:

{
  "mcpServers": {
    "shadcn-ui-server": {
      "command": "npx",
      "args": ["@heilgar/shadcn-ui-mcp-server"]
    }
  }
}

Development and Debugging

Local Development

  1. Install dependencies:
npm install
  1. Build the server:
npm run build

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector for debugging:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser, allowing you to:

  • Monitor MCP communication
  • Inspect tool calls and responses
  • Debug server behavior
  • View real-time logs

Related Projects and Dependencies

This project is built using the following tools and libraries:

License

MIT License - feel free to use this project for your own purposes.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Ver o original no GitHub

Bom para

Relacionados