Repolode
Jpisnice

Jpisnice/shadcn-ui-mcp-server

Un servidor MCP que da acceso a los asistentes de IA al código fuente, las demos, los bloques y los metadatos de instalación de componentes de shadcn/ui para React, Svelte, Vue y React Native.

Estrellas
3,065
Forks
315
Issues abiertos
7
Último commit
hace 19 días

¿Qué es?

Este proyecto es un servidor Model Context Protocol (MCP) que permite a los asistentes de programación con IA consultar componentes de shadcn/ui, incluido su código fuente en TypeScript, demos, bloques como dashboards y formularios, y metadatos sobre dependencias y configuración. En lugar de tener que adivinar las API de los componentes, el asistente puede leer la implementación real antes de generar código.

Admite cuatro bibliotecas basadas en shadcn: la original de React, shadcn-svelte, shadcn-vue y react-native-reusables para React Native. El framework se selecciona con una opción de línea de comandos, y quienes usan React pueden cambiar la biblioteca de primitivas subyacente entre Radix UI y Base UI. El servidor funciona mediante stdio para clientes locales como Claude Desktop, Claude Code y Cursor, o mediante Streamable HTTP en un endpoint /mcp sin estado, con compatibilidad con Docker Compose. El acceso a la API de GitHub se almacena en caché y puede usar un token de acceso personal para aumentar los límites de solicitudes.

Funciones clave

  • 01Devuelve código fuente, demos y bloques de componentes para React, Svelte, Vue y React Native.
  • 02Proporciona metadatos de dependencias, descripción y configuración para cada componente.
  • 03Permite explorar las estructuras de directorios de los repositorios.
  • 04Ofrece modos de transporte stdio, Streamable HTTP y dual.
  • 05Incluye autocompletado de argumentos para prompts y plantillas de recursos.
  • 06Incluye configuración para Docker y Docker Compose.

Casos de uso

  • Permitir que Claude Code o Cursor generen interfaces basadas en shadcn/ui que se ajusten a las API reales de los componentes.
  • Comparar cómo se implementa el mismo componente en React, Svelte, Vue y React Native.
  • Configurar un endpoint MCP compartido para un equipo de desarrolladores mediante HTTP.

Inicio rápido

  1. 1

    Ejecuta el servidor con npx (60 solicitudes por hora sin un token).

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

    Ejecuta el servidor con un token de GitHub para obtener límites de solicitudes más altos (5000 solicitudes por hora).

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

    Cambia a otro framework, como Svelte, Vue o React Native.

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

Antes de usarlo

  • Sin un token de GitHub, los límites de solicitudes de la API de GitHub son bajos (60 solicitudes por hora).
  • La opción de biblioteca de UI Base UI solo está disponible para React.

En colecciones

Temas

Preguntas frecuentes

¿Qué es shadcn-ui-mcp-server?
Un servidor MCP que da acceso a los asistentes de IA al código fuente, las demos, los bloques y los metadatos de instalación de componentes de shadcn/ui para React, Svelte, Vue y React Native. Este proyecto es un servidor Model Context Protocol (MCP) que permite a los asistentes de programación con IA consultar componentes de shadcn/ui, incluido su código fuente en TypeScript, demos, bloques como dashboards y formularios, y metadatos sobre dependencias y configuración. En lugar de tener que adivinar las API de los componentes, el asistente puede leer la implementación real antes de generar código.
¿shadcn-ui-mcp-server es gratuito? ¿Qué licencia tiene?
shadcn-ui-mcp-server es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿shadcn-ui-mcp-server sigue mantenido?
Mantenimiento activo. El último commit de shadcn-ui-mcp-server fue el 3 oct 2026.
¿Para qué puedo usar shadcn-ui-mcp-server?
Permitir que Claude Code o Cursor generen interfaces basadas en shadcn/ui que se ajusten a las API reales de los componentes. Comparar cómo se implementa el mismo componente en React, Svelte, Vue y React Native. Configurar un endpoint MCP compartido para un equipo de desarrolladores mediante HTTP.
¿Cómo se instala shadcn-ui-mcp-server?
Ejecuta el servidor con npx (60 solicitudes por hora sin un token).: npx @jpisnice/shadcn-ui-mcp-server Ejecuta el servidor con un token de GitHub para obtener límites de solicitudes más altos (5000 solicitudes por hora).: npx @jpisnice/shadcn-ui-mcp-server --github-api-key ghp_your_token_here Cambia a otro framework, como Svelte, Vue o React Native.: npx @jpisnice/shadcn-ui-mcp-server --framework svelte
¿Dónde consigo shadcn-ui-mcp-server?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Jpisnice/shadcn-ui-mcp-server

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados