Starwind UI MCP Server

Un servidor TypeScript del Protocolo de Contexto de Modelo para Starwind UI v3 y Starwind Pro. Proporciona a los clientes de IA una guía actualizada y consciente del framework para proyectos de Astro y React.

Inicio rápido

Para la guía de configuración del cliente mantenida, consulta la documentación de Starwind UI MCP.

Codex (~/.codex/config.toml):

[mcp_servers.starwind_ui]
command = "npx"
args = ["-y", "@starwind-ui/mcp"]
enabled = true

Claude Code (.mcp.json) o Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "starwind-ui": {
      "command": "npx",
      "args": ["-y", "@starwind-ui/mcp"]
    }
  }
}

Reinicia el cliente o recarga sus servidores MCP después de cambiar la configuración.

Related MCP server: shadcn-ui MCP Server

Modelo v3

Starwind UI v3 tiene tres superficies relacionadas. El MCP las mantiene diferenciadas:

El servidor valida estas capas contra el ai-manifest.json versionado, almacena en caché los datos validados y recurre a una instantánea empaquetada de v3 si el sitio no está disponible.

Herramientas

Las llamadas a herramientas devuelven tanto texto JSON legible como structuredContent de MCP.

Requisitos y comportamiento

• Los comandos generados de la CLI v3 requieren Node.js 22.12.0 o superior.

• starwind_init se dirige a proyectos existentes de Astro 5+ o React 18+ y permite que la CLI detecte automáticamente el framework a menos que se proporcione framework.

• Los bloques gratuitos del catálogo @starwind-pro/* funcionan después de la inicialización normal. Los bloques de pago requieren autorización explícita; pasa pro: true solo cuando sea necesario.

• Los bloques de Starwind Pro actualmente se dirigen a Astro. Las búsquedas de React los omiten, y las solicitudes de adición de React los rechazan explícitamente.

• La migración es interactiva por defecto. Establece yes: true solo cuando se pretenda un comportamiento de copia de seguridad y sobrescritura.

• El contexto del gestor de paquetes y del proyecto se detecta localmente cuando es posible, y los comandos de adición pasan el gestor de paquetes resuelto a la CLI. Ninguna herramienta ejecuta el comando generado.

Actualización de gratuito a Pro

El MCP mantiene Pro detectable sin forzar la configuración de pago. Los resultados de búsqueda enlazan al catálogo de Pro, los bloques Pro gratuitos siguen siendo directamente instalables, y los resultados de pago incluyen una ruta estructurada proUpgrade con enlaces de compra e instalación.

Para un proyecto existente de Astro, el MCP recomienda:

pnpm dlx starwind@latest setup --yes

El comando de configuración detecta automáticamente el gestor de paquetes del proyecto, por lo que no necesita una bandera --package-manager. Prepara el registro Pro y .env.local; reemplaza el marcador de posición STARWIND_LICENSE_KEY con la clave comprada, luego ejecuta el deferredCommand devuelto. Trata la clave como sensible: mantén .env.local fuera del control de versiones y nunca expongas la clave en registros o código del lado del cliente. Un proyecto inicializado con pro: true recibe el comando equivalente init --pro en su lugar.

Desarrollo

pnpm build
pnpm lint
pnpm test:run

Ejecuta la prueba de contrato de manifiesto de producción opcional con:

RUN_LIVE_CONTRACT_TESTS=1 pnpm test:run src/utils/starwind_live_contract.test.ts

Licencia

MIT. Ver LICENSE.

Seguridad