@ng-solid/mcp

Servidor MCP que expone por stdio un snapshot generado en build del design system Arvisfy (@ng-solid/design-system + @ng-solid/icons): componentes (props/eventos/modelos, con herencia resuelta), tokens de tema con resolución de contraste light/dark, servicios, providers, el catálogo de 1790 iconos Lucide, el contrato de estilos y 6 guías de uso. Pensado para que un agente de IA que consuma @ng-solid/design-system en un proyecto externo trabaje con la API real en vez de inventarla — ver la arquitectura completa y el pipeline de datos en GUIDE.md.

Requisitos

• Node ^24.0.0.
• Nada más: el servidor no necesita el monorepo ng-solid ni @ng-solid/design-system instalados en el proyecto consumidor. El snapshot de componentes, tokens e iconos viaja generado dentro del propio paquete — npx -y @ng-solid/mcp basta.

Instalación por cliente MCP

Claude Code

claude mcp add ng-solid -- npx -y @ng-solid/mcp

O en .mcp.json (raíz del proyecto consumidor):

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

OpenAI Codex

codex mcp add ng-solid -- npx -y @ng-solid/mcp

O en ~/.codex/config.toml:

[mcp_servers.ng-solid]
command = "npx"
args = ["-y", "@ng-solid/mcp"]

Cursor

Crea o edita .cursor/mcp.json:

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

VS Code

1. Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P) → MCP: Add Server.
2. Selecciona Command (stdio).
3. Comando: npx. Argumentos: -y @ng-solid/mcp.
4. Nombre del servidor: ng-solid.

O edita .vscode/mcp.json:

{
  "servers": {
    "ng-solid": {
      "command": "npx",
      "args": ["-y", "@ng-solid/mcp"]
    }
  }
}

install-skills — distribuir las guías como ficheros

El mismo binario copia las 6 guías (packages/mcp/skills/*/SKILL.md, ya resueltas — sin marcadores <!-- ns:… --> pendientes) a un directorio de skills local, útil para agentes que leen ficheros SKILL.md en vez de consultar el MCP por stdio:

npx -y @ng-solid/mcp install-skills              # copia a ./.agents/skills/
npx -y @ng-solid/mcp install-skills --list        # lista las skills sin copiar
npx -y @ng-solid/mcp install-skills --dir ./docs/skills --force

• --dir <ruta> — directorio destino (default ./.agents/skills).
• --list — enumera las skills disponibles sin copiar nada.
• --force — sobreescribe skills ya presentes en el destino; sin ella, una skill existente se salta con un aviso.

Tools por grupo (32)

Descubrimiento — list_components, get_component, search_components, search_all, suggest_component, get_related_components, get_categories.

API de componentes — get_component_api, get_component_import, generate_component_template, get_usage_example, export_component_docs.

Formularios — get_form_control_contract, list_form_controls.

Servicios y providers — list_services, get_service, get_provider.

Tokens/tema — get_component_tokens, list_theme_tokens, resolve_token, get_token_scope, validate_theme_preset, get_token_drift.

Contrato de estilos — get_style_contract, validate_style_contract, validate_component_usage.

Iconos — search_icons, get_icon, get_icons_setup.

Guías/meta — list_guides, get_guide, get_version_info.

Resources y prompts

Ver el detalle de URIs ns://… y de los prompts (build_ns_ui, review_ns_usage, choose_ns_component, build_ns_form, theme_ns_app, migrate_to_ns) en GUIDE.md.

Desarrollo local

Esto es para contribuir al paquete @ng-solid/mcp dentro de este monorepo, no para consumirlo — para eso usa npx -y @ng-solid/mcp como en las secciones de arriba. Desde la raíz del monorepo:

pnpm exec nx run mcp:build          # prebuild + tsc + postbuild -> dist/packages/mcp
node dist/packages/mcp/index.js     # servidor por stdio

Regenerar sólo el snapshot de datos:

pnpm exec nx run mcp:build-data     # escribe packages/mcp/data/*.json y data/skills/
pnpm exec nx run mcp:check-data     # falla si el snapshot en disco quedó desactualizado

Inspector MCP contra el build compilado:

cd packages/mcp
pnpm run inspect