Shadcn Dashboard MCP

Kit de dashboard Shadcn pronto para produção, construído para equipes modernas

Documentação

shadcndashboard-mcp

Servidor oficial do Model Context Protocol (MCP) para Shadcn Dashboard.

Este servidor MCP permite que IDEs e agentes com IA descubram, pesquisem e instalem blocos de UI do Shadcn Dashboard diretamente em seus projetos — com cache em memória, listagens leves e eficientes em tokens, descoberta antecipada de versões Free vs PRO, blueprints de composição de layout e snippets de código JSX automáticos.

Instalar configuração do MCP

npx shadcndashboard-cli install <client>

Clientes suportados

Instalação manual

Adicione ao arquivo de configuração do MCP da sua IDE:

{
  "mcpServers": {
    "shadcndashboard-mcp": {
      "command": "npx",
      "args": ["-y", "shadcndashboard-mcp@latest"]
    }
  }
}

Para o MCP, visite a PÁGINA PRINCIPAL
Para mais informações, consulte nossa documentação sobre Como usar o Servidor MCP

Ferramentas disponíveis

O servidor fornece as seguintes ferramentas acionáveis via MCP:

Nome da Ferramenta	Descrição
`get_audit_checklist`	Execute primeiro. Retorna regras estritas de fluxo de trabalho, pré-requisitos do `components.json`, regras de Free vs PRO e requisitos de layout do shell.
`listBlocks`	Lista todos os blocos do Shadcn Dashboard com filtros por categoria (`shells`, `charts`, `metrics`, `tables`, `forms`, `layout`, `ai-ops`) e nível de licença (`free`, `pro`, `all`).
`listFreeBlocks`	Ferramenta de atalho dedicada para listar apenas blocos 100% gratuitos que não exigem licença.
`listComponents`	Fornece uma lista leve de componentes de UI do Shadcn Dashboard com filtragem opcional por nível.
`getBlockInstall`	Retorna o comando oficial de instalação, o nome de exportação do componente, a instrução de importação e um snippet de uso JSX limpo.
`searchBlocks`	Pesquisa blocos por palavras-chave ou tags com filtragem opcional por nível de licença (`free`, `pro`, `all`).
`listInstalledBlocks`	Lista todos os blocos atualmente instalados no projeto.
`getDashboardLayoutGuidelines`	Obtém regras de prioridade do shell do dashboard, receitas de composição por domínio (AI Ops, SaaS, Ecommerce, Logística, Saúde) e diretrizes de alinhamento e balanceamento de altura com CSS Grid / Flex.
`handleError`	Classificador inteligente de erros e guia de recuperação para erros de `components.json` ausente, licença, CLI ou não encontrado.

Prompts disponíveis

O servidor fornece prompts ricos para orientar agentes de IA em fluxos de trabalho comuns:

Prompt/Comando	Descrição
`search`	Pesquisa componentes ou blocos por tópico.
`create-ui`	Arquitetura uma página de UI completa usando shells de dashboard pré-construídos e layouts de grade balanceados.
`build-dashboard`	Cria um dashboard completo específico de domínio (AI Ops, Ecommerce, SaaS/AI, Logística, POS para Restaurantes, Escola, Saúde).
`add-analytics-section`	Adiciona uma seção moderna de análises e gráficos com cartões de métricas a uma página existente.
`create-auth-flow`	Gera páginas de autenticação (login, cadastro, OTP, esqueci a senha, onboarding em várias etapas).
`create-data-view`	Cria uma visualização de gerenciamento de dados com filtragem, pesquisa e paginação.
`customization-guidelines`	Define quais partes dos blocos instalados podem ser modificadas com segurança (somente texto).

Exemplo de uso

Após a configuração, seu agente de IA pode executar tarefas como:

"Liste todos os shells de dashboard gratuitos" -> A IA chama listFreeBlocks(category: "shells")

"Me dê o comando de instalação para dashboard-shell-01" -> A IA chama getBlockInstall(name: "dashboard-shell-01", packageManager: "pnpm dlx") e obtém o comando + snippet de importação!

"Crie um layout de dashboard de análises SaaS" -> A IA usa build-dashboard e segue getDashboardLayoutGuidelines

"Pesquise blocos de gráficos gratuitos" -> A IA chama searchBlocks(query: "chart", tier: "free")

Instruções para agentes (Claude / Cursor / Windsurf)

Se você estiver usando Claude Projects, Cursor ou Windsurf, preparamos um conjunto de instruções que você pode copiar e colar para fazer sua IA usar este Servidor MCP perfeitamente. Consulte claude-instructions.md.

Créditos

Criado por shadcndashboard.

MIT