Repolode
Jpisnice

Jpisnice/shadcn-ui-mcp-server

Um servidor MCP que dá a assistentes de IA acesso ao código-fonte, às demonstrações, aos blocos e aos metadados de instalação de componentes shadcn/ui para React, Svelte, Vue e React Native.

Estrelas
3,065
Forks
315
Issues abertas
7
Último commit
há 19 dias

O que é?

Este projeto é um servidor do Model Context Protocol (MCP) que permite que assistentes de programação com IA consultem componentes shadcn/ui, incluindo código-fonte em TypeScript, demonstrações, blocos como dashboards e formulários, além de metadados de dependências e configuração. Em vez de adivinhar as APIs dos componentes, o assistente pode ler a implementação real antes de gerar código.

Ele abrange quatro bibliotecas no estilo shadcn: a original para React, shadcn-svelte, shadcn-vue e react-native-reusables para React Native. O framework é escolhido com uma flag de linha de comando, e usuários de React podem alternar a biblioteca de primitivas usada entre Radix UI e Base UI. O servidor funciona via stdio para clientes locais como Claude Desktop, Claude Code e Cursor, ou via Streamable HTTP em um endpoint /mcp sem estado, com suporte a Docker Compose. O acesso à API do GitHub é armazenado em cache e pode usar um personal access token para aumentar os limites de requisições.

Recursos principais

  • 01Retorna código-fonte de componentes, demonstrações e blocos para React, Svelte, Vue e React Native.
  • 02Fornece metadados de dependências, descrição e configuração de cada componente.
  • 03Permite explorar as estruturas de diretórios dos repositórios.
  • 04Oferece os modos de transporte stdio, Streamable HTTP e dual.
  • 05Inclui autocompletar argumentos para prompts e templates de recursos.
  • 06Inclui configurações para Docker e Docker Compose.

Casos de uso

  • Permitir que Claude Code ou Cursor gere interfaces com shadcn/ui que sigam as APIs reais dos componentes.
  • Comparar como o mesmo componente é implementado em React, Svelte, Vue e React Native.
  • Disponibilizar um endpoint MCP compartilhado para uma equipe de desenvolvedores via HTTP.

Início rápido

  1. 1

    Execute o servidor com npx (60 solicitações por hora sem um token).

    npx @jpisnice/shadcn-ui-mcp-server
  2. 2

    Execute com um token do GitHub para obter limites de solicitações maiores (5.000 solicitações por hora).

    npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here
  3. 3

    Mude para outro framework, como Svelte, Vue ou React Native.

    npx @jpisnice/shadcn-ui-mcp-server --framework svelte

Antes de usar

  • Sem um token do GitHub, os limites de solicitações da API do GitHub são baixos (60 solicitações por hora).
  • A opção de biblioteca de UI Base UI está disponível apenas para React.

Em coleções

Tópicos

Perguntas frequentes

O que é shadcn-ui-mcp-server?
Um servidor MCP que dá a assistentes de IA acesso ao código-fonte, às demonstrações, aos blocos e aos metadados de instalação de componentes shadcn/ui para React, Svelte, Vue e React Native. Este projeto é um servidor do Model Context Protocol (MCP) que permite que assistentes de programação com IA consultem componentes shadcn/ui, incluindo código-fonte em TypeScript, demonstrações, blocos como dashboards e formulários, além de metadados de dependências e configuração. Em vez de adivinhar as APIs dos componentes, o assistente pode ler a implementação real antes de gerar código.
shadcn-ui-mcp-server é gratuito? Qual é a licença?
shadcn-ui-mcp-server é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
shadcn-ui-mcp-server ainda é mantido?
Manutenção ativa. O último commit de shadcn-ui-mcp-server foi em 3 de out. de 2026.
Para que posso usar shadcn-ui-mcp-server?
Permitir que Claude Code ou Cursor gere interfaces com shadcn/ui que sigam as APIs reais dos componentes. Comparar como o mesmo componente é implementado em React, Svelte, Vue e React Native. Disponibilizar um endpoint MCP compartilhado para uma equipe de desenvolvedores via HTTP.
Como instalar shadcn-ui-mcp-server?
Execute o servidor com npx (60 solicitações por hora sem um token).: npx @jpisnice/shadcn-ui-mcp-server Execute com um token do GitHub para obter limites de solicitações maiores (5.000 solicitações por hora).: npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here Mude para outro framework, como Svelte, Vue ou React Native.: npx @jpisnice/shadcn-ui-mcp-server --framework svelte
Onde consigo shadcn-ui-mcp-server?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Jpisnice/shadcn-ui-mcp-server

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados