npm - @dgplsoares/singulai-ds-mcp - Versions diffs - 0.1.0 - Mend

@dgplsoares/singulai-ds-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Diogo Soares
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,148 @@
+# @dgplsoares/singulai-ds-mcp
+> MCP server exposing the [Singulai Design System](https://design.singulai.ai) (Angular 20) to AI agents — Claude Desktop, Claude Code, Cursor, Continue, and any other [MCP](https://modelcontextprotocol.io/)-compatible client.
+[![npm version](https://img.shields.io/npm/v/@dgplsoares/singulai-ds-mcp.svg)](https://www.npmjs.com/package/@dgplsoares/singulai-ds-mcp)
+[![Live Showcase](https://img.shields.io/badge/showcase-design.singulai.ai-2563EB)](https://design.singulai.ai)
+[![License](https://img.shields.io/badge/license-MIT-22C55E)](./LICENSE)
+🚧 **Alpha (v0.1.x)** — funcional, não recomendado para produção alheia ainda. API das tools e shape do catálogo estabilizam em v1.0.
+## O que é?
+Um [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server que expõe o catálogo do **Singulai Design System** (15 componentes Angular 20 standalone + signals + neumorphic) como tools que qualquer AI agent consegue chamar. Casos de uso típicos:
+- _"Quais componentes existem nesse design system?"_ → tool retorna catálogo
+- _"Componente para botão com loading state?"_ → tool retorna `<ds-button>` + exemplo
+- _"Quais @Input existem em `<ds-form-field>`?"_ → tool retorna props tipados
+O agente AI usa as tools automaticamente quando o usuário pede algo relacionado ao DS — sem precisar ler docs.
+## Tools v0.1
+| Tool | Função |
+|---|---|
+| **`list_components()`** | Lista os 15 componentes (nome + selector + descrição curta + tags) |
+| **`get_component(name)`** | Info completa: descrição, props tipados (com defaults), outputs, exemplos. Aceita selector (`ds-button`) ou nome de classe (`ButtonComponent`) |
+| **`search_components(query, limit?)`** | Busca por palavras-chave em selector + nome + tags + descrição, com scoring |
+## Instalação
+### Opção 1 — Claude Code (CLI)
+Adicione ao seu `~/.claude/settings.json`:
+```json
+{
+  "mcpServers": {
+    "singulai-ds": {
+      "command": "npx",
+      "args": ["-y", "@dgplsoares/singulai-ds-mcp"]
+    }
+  }
+}
+```
+Reinicie o Claude Code. Pergunte: _"quais componentes existem no Singulai Design System?"_ — o agente vai chamar `list_components` automaticamente.
+### Opção 2 — Claude Desktop
+Edite o arquivo de config (location varia por SO):
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux:** `~/.config/Claude/claude_desktop_config.json`
+```json
+{
+  "mcpServers": {
+    "singulai-ds": {
+      "command": "npx",
+      "args": ["-y", "@dgplsoares/singulai-ds-mcp"]
+    }
+  }
+}
+```
+Reinicie o Claude Desktop.
+### Opção 3 — Cursor
+Em Settings → Features → Model Context Protocol:
+```json
+{
+  "mcpServers": {
+    "singulai-ds": {
+      "command": "npx",
+      "args": ["-y", "@dgplsoares/singulai-ds-mcp"]
+    }
+  }
+}
+```
+### Opção 4 — Outros clientes MCP
+Qualquer cliente compatível com [MCP stdio transport](https://modelcontextprotocol.io/docs/concepts/transports#standard-input-output-stdio) pode rodar este server. Comando: `npx -y @dgplsoares/singulai-ds-mcp`.
+## Verificação rápida
+Após adicionar a config e reiniciar o cliente, peça ao agente:
+```
+Quais componentes existem no Singulai Design System?
+```
+A resposta deve listar os 15 componentes (button, card, form-field, sidebar-left-nav, page-layout, page-header, nav-footer, ai-assistant-panel, statsbar-card, segmented-tabs, icon-neumorphic, card-panel, ai-assistant-button, dark-mode-button, notifications-button).
+Outras perguntas para testar:
+- _"Como uso o `<ds-button>`?"_ — chama `get_component`
+- _"Componente para chat de AI?"_ — chama `search_components`
+- _"Quais props o FormFieldComponent aceita?"_ — chama `get_component`
+## Status
+| Fase | Tools |
+|---|---|
+| ✅ MCP-1/2/3 (atual) | `list_components`, `get_component`, `search_components` |
+| ✅ MCP-4 | npm publish + docs de instalação |
+| 🟡 MCP-5 | validação em Claude Code |
+| 🔜 v0.2+ | `get_tokens`, `get_examples`, `get_theme_overrides`, catálogo auto-gerado via ts-morph |
+## Stack
+- TypeScript + Node 20+
+- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk) (oficial Anthropic)
+- [zod](https://zod.dev) para validação de schema
+- Stdio transport (padrão MCP)
+## Desenvolvimento
+```bash
+git clone git@github.com:dgplsoares/singulai-design-system-mcp.git
+cd singulai-design-system-mcp
+npm install
+npm run dev    # tsx src/index.ts
+npm run build  # tsc + copia src/data → dist/data
+npm start      # node dist/index.js
+```
+Smoke test stdio (cole inteiro em um terminal):
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"1.0"}}}
+{"jsonrpc":"2.0","method":"notifications/initialized"}
+{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/index.js
+```
+## License
+[MIT](./LICENSE) — Diogo Soares · 2026
+## Links
+- 🌐 Live showcase: https://design.singulai.ai
+- 📦 Design System (mirror público): https://github.com/dgplsoares/singulai-design-system
+- 📦 NPM: https://www.npmjs.com/package/@dgplsoares/singulai-ds-mcp
+- 👤 Autor: [LinkedIn](https://www.linkedin.com/in/dgsoares/) · [GitHub](https://github.com/dgplsoares)

package/dist/catalog.d.ts ADDED Viewed

@@ -0,0 +1,272 @@
+/**
+ * Carrega e valida o catalog.json em memoria.
+ * Schema zod garante consistencia entre v0.1 (manual) e v0.2 (auto-gerado
+ * via ts-morph) — se a forma mudar incompativelmente, o servidor falha
+ * imediatamente em vez de retornar dados malformados aos AI agents.
+ */
+import { z } from 'zod';
+declare const PropSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: string;
+    description: string;
+    required?: boolean | undefined;
+    default?: string | undefined;
+}, {
+    name: string;
+    type: string;
+    description: string;
+    required?: boolean | undefined;
+    default?: string | undefined;
+}>;
+declare const ComponentSchema: z.ZodObject<{
+    name: z.ZodString;
+    selector: z.ZodString;
+    description: z.ZodString;
+    tags: z.ZodArray<z.ZodString, "many">;
+    props: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodString>;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: string;
+        description: string;
+        required?: boolean | undefined;
+        default?: string | undefined;
+    }, {
+        name: string;
+        type: string;
+        description: string;
+        required?: boolean | undefined;
+        default?: string | undefined;
+    }>, "many">;
+    outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: string;
+    }, {
+        name: string;
+        type: string;
+    }>, "many">>;
+    examples: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    selector: string;
+    tags: string[];
+    props: {
+        name: string;
+        type: string;
+        description: string;
+        required?: boolean | undefined;
+        default?: string | undefined;
+    }[];
+    examples: string[];
+    outputs?: {
+        name: string;
+        type: string;
+    }[] | undefined;
+}, {
+    name: string;
+    description: string;
+    selector: string;
+    tags: string[];
+    props: {
+        name: string;
+        type: string;
+        description: string;
+        required?: boolean | undefined;
+        default?: string | undefined;
+    }[];
+    outputs?: {
+        name: string;
+        type: string;
+    }[] | undefined;
+    examples?: string[] | undefined;
+}>;
+declare const CatalogSchema: z.ZodObject<{
+    version: z.ZodString;
+    generated_at: z.ZodString;
+    design_system: z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+        homepage: z.ZodString;
+        repo: z.ZodString;
+        stack: z.ZodArray<z.ZodString, "many">;
+        principles: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        homepage: string;
+        repo: string;
+        stack: string[];
+        principles: string[];
+    }, {
+        name: string;
+        version: string;
+        homepage: string;
+        repo: string;
+        stack: string[];
+        principles: string[];
+    }>;
+    types: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    components: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        selector: z.ZodString;
+        description: z.ZodString;
+        tags: z.ZodArray<z.ZodString, "many">;
+        props: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: string;
+            description: string;
+            required?: boolean | undefined;
+            default?: string | undefined;
+        }, {
+            name: string;
+            type: string;
+            description: string;
+            required?: boolean | undefined;
+            default?: string | undefined;
+        }>, "many">;
+        outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: string;
+        }, {
+            name: string;
+            type: string;
+        }>, "many">>;
+        examples: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        selector: string;
+        tags: string[];
+        props: {
+            name: string;
+            type: string;
+            description: string;
+            required?: boolean | undefined;
+            default?: string | undefined;
+        }[];
+        examples: string[];
+        outputs?: {
+            name: string;
+            type: string;
+        }[] | undefined;
+    }, {
+        name: string;
+        description: string;
+        selector: string;
+        tags: string[];
+        props: {
+            name: string;
+            type: string;
+            description: string;
+            required?: boolean | undefined;
+            default?: string | undefined;
+        }[];
+        outputs?: {
+            name: string;
+            type: string;
+        }[] | undefined;
+        examples?: string[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    generated_at: string;
+    design_system: {
+        name: string;
+        version: string;
+        homepage: string;
+        repo: string;
+        stack: string[];
+        principles: string[];
+    };
+    types: Record<string, string[]>;
+    components: {
+        name: string;
+        description: string;
+        selector: string;
+        tags: string[];
+        props: {
+            name: string;
+            type: string;
+            description: string;
+            required?: boolean | undefined;
+            default?: string | undefined;
+        }[];
+        examples: string[];
+        outputs?: {
+            name: string;
+            type: string;
+        }[] | undefined;
+    }[];
+}, {
+    version: string;
+    generated_at: string;
+    design_system: {
+        name: string;
+        version: string;
+        homepage: string;
+        repo: string;
+        stack: string[];
+        principles: string[];
+    };
+    types: Record<string, string[]>;
+    components: {
+        name: string;
+        description: string;
+        selector: string;
+        tags: string[];
+        props: {
+            name: string;
+            type: string;
+            description: string;
+            required?: boolean | undefined;
+            default?: string | undefined;
+        }[];
+        outputs?: {
+            name: string;
+            type: string;
+        }[] | undefined;
+        examples?: string[] | undefined;
+    }[];
+}>;
+export type Catalog = z.infer<typeof CatalogSchema>;
+export type CatalogComponent = z.infer<typeof ComponentSchema>;
+export type CatalogProp = z.infer<typeof PropSchema>;
+export declare function loadCatalog(): Catalog;
+/**
+ * Encontra um componente por name (ButtonComponent) ou selector (ds-button).
+ * Case-insensitive. Retorna null se nao encontrar.
+ */
+export declare function findComponent(catalog: Catalog, query: string): CatalogComponent | null;
+/**
+ * Busca componentes por palavra-chave em name + selector + description + tags.
+ * Score simples: match em selector/name pesa mais que em description/tags.
+ * Retorna ate `limit` resultados ordenados por score desc.
+ */
+export declare function searchComponents(catalog: Catalog, query: string, limit?: number): Array<{
+    component: CatalogComponent;
+    score: number;
+}>;
+export {};

package/dist/catalog.js ADDED Viewed

@@ -0,0 +1,114 @@
+/**
+ * Carrega e valida o catalog.json em memoria.
+ * Schema zod garante consistencia entre v0.1 (manual) e v0.2 (auto-gerado
+ * via ts-morph) — se a forma mudar incompativelmente, o servidor falha
+ * imediatamente em vez de retornar dados malformados aos AI agents.
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const PropSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    required: z.boolean().optional(),
+    default: z.string().optional(),
+    description: z.string(),
+});
+const OutputSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+});
+const ComponentSchema = z.object({
+    name: z.string(),
+    selector: z.string(),
+    description: z.string(),
+    tags: z.array(z.string()),
+    props: z.array(PropSchema),
+    outputs: z.array(OutputSchema).optional(),
+    examples: z.array(z.string()).default([]),
+});
+const CatalogSchema = z.object({
+    version: z.string(),
+    generated_at: z.string(),
+    design_system: z.object({
+        name: z.string(),
+        version: z.string(),
+        homepage: z.string(),
+        repo: z.string(),
+        stack: z.array(z.string()),
+        principles: z.array(z.string()),
+    }),
+    types: z.record(z.string(), z.array(z.string())),
+    components: z.array(ComponentSchema),
+});
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const CATALOG_PATH = resolve(__dirname, 'data/catalog.json');
+let cachedCatalog = null;
+export function loadCatalog() {
+    if (cachedCatalog)
+        return cachedCatalog;
+    const raw = readFileSync(CATALOG_PATH, 'utf-8');
+    const parsed = JSON.parse(raw);
+    const validated = CatalogSchema.parse(parsed);
+    cachedCatalog = validated;
+    return validated;
+}
+// ---------------------------------------------------------------------------
+// Helpers de busca (usados pelas tools)
+// ---------------------------------------------------------------------------
+/**
+ * Encontra um componente por name (ButtonComponent) ou selector (ds-button).
+ * Case-insensitive. Retorna null se nao encontrar.
+ */
+export function findComponent(catalog, query) {
+    const q = query.trim().toLowerCase();
+    return (catalog.components.find((c) => c.name.toLowerCase() === q || c.selector.toLowerCase() === q) ?? null);
+}
+/**
+ * Busca componentes por palavra-chave em name + selector + description + tags.
+ * Score simples: match em selector/name pesa mais que em description/tags.
+ * Retorna ate `limit` resultados ordenados por score desc.
+ */
+export function searchComponents(catalog, query, limit = 5) {
+    const terms = query
+        .trim()
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((t) => t.length > 0);
+    if (terms.length === 0)
+        return [];
+    const scored = catalog.components
+        .map((component) => {
+        const haystack = {
+            selector: component.selector.toLowerCase(),
+            name: component.name.toLowerCase(),
+            description: component.description.toLowerCase(),
+            tags: component.tags.join(' ').toLowerCase(),
+        };
+        let score = 0;
+        for (const term of terms) {
+            if (haystack.selector.includes(term))
+                score += 5;
+            if (haystack.name.includes(term))
+                score += 4;
+            if (haystack.tags.includes(term))
+                score += 3;
+            if (haystack.description.includes(term))
+                score += 1;
+        }
+        return { component, score };
+    })
+        .filter((r) => r.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    return scored;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}

package/dist/data/catalog.json ADDED Viewed

@@ -0,0 +1,358 @@
+{
+  "version": "0.1.0",
+  "generated_at": "2026-05-08",
+  "design_system": {
+    "name": "Singulai Design System",
+    "version": "DS-2.1",
+    "homepage": "https://design.singulai.ai",
+    "repo": "https://github.com/dgplsoares/singulai-design-system",
+    "stack": [
+      "Angular 20",
+      "Standalone Components",
+      "Signals",
+      "SCSS Tokens",
+      "Neumorphic"
+    ],
+    "principles": [
+      "Standalone components — no NgModule required",
+      "Signal-based inputs (input(), input.required())",
+      "Mobile-first with 100dvh + overscroll-behavior:none",
+      "Themeable via CSS variables (no Tailwind inside DS)",
+      "Brand assets configurable via @Input (split-ready)"
+    ]
+  },
+  "types": {
+    "ButtonVariant": ["primary-cta", "solid", "outline", "action", "icon", "submit", "sidebar", "modal-cancel"],
+    "ButtonSize": ["sm", "md", "lg"],
+    "ButtonVariantColor": ["primary", "secondary", "tertiary", "success", "danger", "warning", "dark", "goal", "apex"],
+    "ButtonType": ["button", "submit", "reset"],
+    "CardVariant": ["default", "dashboard", "with-tabs", "simple", "inner-card"],
+    "CardState": ["default", "loading", "empty", "error"],
+    "FormFieldVariant": ["text", "textarea", "select", "toggle", "search"],
+    "FormFieldSize": ["sm", "md", "lg"],
+    "FormFieldType": ["text", "email", "password", "number", "tel", "url"],
+    "IconNeumorphicSize": ["sm", "md", "lg"],
+    "IconNeumorphicVariant": ["default", "apex", "success", "warning", "danger", "info", "purple"],
+    "PageHeaderVariant": ["default", "module-dashboard", "screen-list", "screen-create", "screen-detail"],
+    "PageLayoutVariant": ["dashboard", "list", "wizard", "tabs-internas", "detail-fullwidth"],
+    "AiAssistantLayoutState": ["closed", "open"],
+    "NavFooterPanel": ["navegue", "ai", "alertas", "conta"],
+    "AiTab": ["current", "new", "chats"],
+    "SidebarState": ["expanded", "collapsed"],
+    "StatsbarCardVariant": ["success", "purple", "warning", "info", "danger", "neutral"],
+    "StatsbarCardDeltaDirection": ["up", "down"]
+  },
+  "components": [
+    {
+      "name": "ButtonComponent",
+      "selector": "ds-button",
+      "description": "Botão unificado do DS — 8 variants estruturais (solid, outline, icon, sidebar, etc.) × 9 cores semânticas. Suporta ícones left/right (heroicons ou imagens), estados loading/disabled e flag active para nav-items.",
+      "tags": ["button", "cta", "action", "form", "navigation", "icon", "loading"],
+      "props": [
+        { "name": "variant", "type": "ButtonVariant", "required": true, "description": "Tipo estrutural do botão." },
+        { "name": "size", "type": "ButtonSize", "default": "'md'", "description": "Tamanho." },
+        { "name": "variantColor", "type": "ButtonVariantColor", "default": "'apex'", "description": "Cor semântica." },
+        { "name": "type", "type": "ButtonType", "default": "'button'", "description": "Atributo HTML type." },
+        { "name": "iconLeft", "type": "string | null", "default": "null", "description": "Nome de ícone heroX (left)." },
+        { "name": "iconImageSrc", "type": "string | null", "default": "null", "description": "Path de SVG/PNG (left). Tem precedência sobre iconLeft." },
+        { "name": "iconImageSize", "type": "string", "default": "'20px'", "description": "Tamanho do ícone via path." },
+        { "name": "iconRight", "type": "string | null", "default": "null", "description": "Nome de ícone heroX (right)." },
+        { "name": "disabled", "type": "boolean", "default": "false", "description": "Estado disabled." },
+        { "name": "loading", "type": "boolean", "default": "false", "description": "Mostra spinner e desabilita interação." },
+        { "name": "ariaLabel", "type": "string | null", "default": "null", "description": "Aria-label customizado." },
+        { "name": "active", "type": "boolean", "default": "false", "description": "Estado active (sidebar nav, toggle, etc.)." }
+      ],
+      "outputs": [
+        { "name": "clicked", "type": "EventEmitter<MouseEvent>" }
+      ],
+      "examples": [
+        "<ds-button variant=\"solid\" variantColor=\"primary\" (clicked)=\"onSave()\">Salvar</ds-button>",
+        "<ds-button variant=\"icon\" iconLeft=\"heroPencil\" ariaLabel=\"Editar\" (clicked)=\"onEdit()\" />",
+        "<ds-button variant=\"primary-cta\" [loading]=\"saving()\" type=\"submit\">Criar conta</ds-button>"
+      ]
+    },
+    {
+      "name": "CardComponent",
+      "selector": "ds-card",
+      "description": "Container genérico do DS — 5 variants de chrome (default, dashboard, with-tabs, simple, inner-card) com slots para título, ícone, tabs de navegação interna e dropdown de ações.",
+      "tags": ["card", "container", "panel", "tabs", "dropdown"],
+      "props": [
+        { "name": "title", "type": "string | null", "default": "null", "description": "Título no header." },
+        { "name": "icon", "type": "string | null", "default": "null", "description": "Ícone heroX no header." },
+        { "name": "variant", "type": "CardVariant", "default": "'default'", "description": "Variant de chrome." },
+        { "name": "state", "type": "CardState", "default": "'default'", "description": "Estado: default, loading, empty, error." },
+        { "name": "navTabs", "type": "CardNavTab[] | null", "default": "null", "description": "Tabs de navegação interna (variant with-tabs)." },
+        { "name": "dropdownItems", "type": "CardDropdownItem[] | null", "default": "null", "description": "Itens de dropdown de ações no header." },
+        { "name": "ariaLabel", "type": "string | null", "default": "null", "description": "Aria-label customizado." }
+      ],
+      "examples": [
+        "<ds-card title=\"Receita mensal\" icon=\"heroChartBar\">\n  <p>R$ 12.480,00</p>\n</ds-card>",
+        "<ds-card variant=\"dashboard\" [state]=\"loading() ? 'loading' : 'default'\">...</ds-card>"
+      ]
+    },
+    {
+      "name": "CardPanelComponent",
+      "selector": "ds-card-panel",
+      "description": "Painel containerizado simples com título obrigatório e estado de loading. Útil para sub-seções dentro de páginas.",
+      "tags": ["panel", "container", "loading", "section"],
+      "props": [
+        { "name": "title", "type": "string", "required": true, "description": "Título do painel." },
+        { "name": "loading", "type": "boolean", "default": "false", "description": "Estado de loading." }
+      ],
+      "examples": [
+        "<ds-card-panel title=\"Pagamentos pendentes\">\n  <ds-data-table [rows]=\"rows()\" />\n</ds-card-panel>"
+      ]
+    },
+    {
+      "name": "FormFieldComponent",
+      "selector": "ds-form-field",
+      "description": "Campo de formulário unificado — 5 variants (text, textarea, select, toggle, search) com ControlValueAccessor para integração com Reactive Forms e Template-driven forms. Suporta hint, errorMessage, required, loading e estados disabled.",
+      "tags": ["form", "input", "textarea", "select", "toggle", "search", "validation", "reactive-forms", "ngmodel"],
+      "props": [
+        { "name": "variant", "type": "FormFieldVariant", "required": true, "description": "Tipo do campo." },
+        { "name": "size", "type": "FormFieldSize", "default": "'md'", "description": "Tamanho." },
+        { "name": "type", "type": "FormFieldType", "default": "'text'", "description": "Atributo HTML type (apenas variant=text)." },
+        { "name": "label", "type": "string | null", "default": "null", "description": "Label exibido acima do campo." },
+        { "name": "placeholder", "type": "string", "default": "''", "description": "Placeholder." },
+        { "name": "hint", "type": "string | null", "default": "null", "description": "Hint abaixo do campo." },
+        { "name": "errorMessage", "type": "string | null", "default": "null", "description": "Mensagem de erro (override do estado interno)." },
+        { "name": "required", "type": "boolean", "default": "false", "description": "Marca como obrigatório (asterisco + aria-required)." },
+        { "name": "disabled", "type": "boolean", "default": "false", "description": "Estado disabled." },
+        { "name": "loading", "type": "boolean", "default": "false", "description": "Spinner no canto direito." },
+        { "name": "rows", "type": "number", "default": "4", "description": "Linhas (apenas variant=textarea)." },
+        { "name": "maxLength", "type": "number | null", "default": "null", "description": "Máximo de caracteres." },
+        { "name": "options", "type": "FormFieldOption[] | null", "default": "null", "description": "Opções (apenas variant=select)." },
+        { "name": "externalDescribedBy", "type": "string | null", "default": "null", "description": "Prefix de aria-describedby externo." },
+        { "name": "chevronDownIconSrc", "type": "string", "default": "'branding/icons/form/chevron-down.svg'", "description": "Override do ícone chevron (split-ready)." },
+        { "name": "searchIconSrc", "type": "string", "default": "'branding/icons/form/search.svg'", "description": "Override do ícone search (split-ready)." }
+      ],
+      "outputs": [
+        { "name": "valueChange", "type": "EventEmitter<unknown>" },
+        { "name": "blurred", "type": "EventEmitter<FocusEvent>" }
+      ],
+      "examples": [
+        "<ds-form-field variant=\"text\" label=\"Nome\" formControlName=\"name\" [required]=\"true\" />",
+        "<ds-form-field variant=\"select\" label=\"Categoria\" [(ngModel)]=\"categoria\" [options]=\"categoriasOptions\" />",
+        "<ds-form-field variant=\"toggle\" label=\"Ativo\" formControlName=\"active\" />",
+        "<ds-form-field variant=\"search\" placeholder=\"Pesquisar...\" [(ngModel)]=\"q\" />"
+      ]
+    },
+    {
+      "name": "IconNeumorphicComponent",
+      "selector": "ds-icon-neumorphic",
+      "description": "Ícone em moldura neumorphic — 3 sizes (sm 28px, md 40px, lg 50px) × 7 variants de cor. Aceita ícone heroX (icon prop) ou path de SVG/PNG (iconImageSrc). Bounding-box quadrada com object-fit:contain garante render correto em mobile.",
+      "tags": ["icon", "neumorphic", "decoration", "kpi"],
+      "props": [
+        { "name": "icon", "type": "string | null", "default": "null", "description": "Nome de ícone heroX (use APENAS se não houver iconImageSrc)." },
+        { "name": "iconImageSrc", "type": "string | null", "default": "null", "description": "Path de SVG/PNG. Tem precedência sobre icon." },
+        { "name": "size", "type": "IconNeumorphicSize", "default": "'md'", "description": "Tamanho do container." },
+        { "name": "variant", "type": "IconNeumorphicVariant", "default": "'default'", "description": "Variant de cor do ícone interno." },
+        { "name": "ariaLabel", "type": "string | null", "default": "null", "description": "Aria-label. Sem isso, o container é decorativo." }
+      ],
+      "examples": [
+        "<ds-icon-neumorphic icon=\"heroChartBar\" size=\"md\" variant=\"apex\" />",
+        "<ds-icon-neumorphic iconImageSrc=\"branding/icons/statsbar/01-revenue.svg\" size=\"lg\" />"
+      ]
+    },
+    {
+      "name": "PageLayoutComponent",
+      "selector": "ds-page-layout",
+      "description": "Skeleton root das telas autenticadas. Container de viewport (100dvh) que organiza sidebar (desktop) + main scrollable + nav-footer (mobile) + AI Assistant overlay. Mobile-first com overscroll-behavior:none.",
+      "tags": ["layout", "shell", "skeleton", "viewport", "responsive", "mobile-first"],
+      "props": [
+        { "name": "variant", "type": "PageLayoutVariant", "default": "'dashboard'", "description": "Variant do layout (afeta padding/scroll do main)." },
+        { "name": "aiAssistantState", "type": "AiAssistantLayoutState", "default": "'closed'", "description": "Estado do AI Assistant (closed | open)." },
+        { "name": "sidebarWidth", "type": "string", "default": "'280px'", "description": "Largura da sidebar expandida." },
+        { "name": "aiAssistantWidth", "type": "string", "default": "'400px'", "description": "Largura do AI Assistant aberto." },
+        { "name": "mainAriaLabel", "type": "string", "default": "'Conteudo principal'", "description": "Aria-label do <main>." },
+        { "name": "dashboardActive", "type": "boolean", "default": "false", "description": "True quando rota = /dashboard (afeta nav-footer)." },
+        { "name": "aiMaximized", "type": "boolean", "default": "false", "description": "AI Assistant em modo maximizado." }
+      ],
+      "examples": [
+        "<ds-page-layout variant=\"dashboard\">\n  <ds-sidebar-left-nav page-layout-sidebar [menuItems]=\"items\" />\n  <ds-page-header page-layout-header title=\"Dashboard\" />\n  <main page-layout-main>...</main>\n</ds-page-layout>"
+      ]
+    },
+    {
+      "name": "PageHeaderComponent",
+      "selector": "ds-page-header",
+      "description": "Header sticky presente em todas as telas autenticadas. Estrutura em 3 zonas: navegação (back/forward + título), breadcrumbs (centro), actions (direita). Variant module-dashboard tem botões Reorganizar/Personalizar.",
+      "tags": ["header", "navigation", "breadcrumbs", "title", "sticky"],
+      "props": [
+        { "name": "variant", "type": "PageHeaderVariant", "default": "'module-dashboard'", "description": "Variant do header." },
+        { "name": "title", "type": "string", "required": true, "description": "Título da tela." },
+        { "name": "icon", "type": "string | null", "default": "null", "description": "Ícone heroX antes do título." },
+        { "name": "breadcrumbs", "type": "PageHeaderBreadcrumb[]", "default": "[]", "description": "Caminho de navegação." },
+        { "name": "canGoBack", "type": "boolean", "default": "false", "description": "Habilita botão voltar." },
+        { "name": "canGoForward", "type": "boolean", "default": "false", "description": "Habilita botão avançar." },
+        { "name": "reorganizeActive", "type": "boolean", "default": "false", "description": "Estado active do botão Reorganizar." },
+        { "name": "customizeActive", "type": "boolean", "default": "false", "description": "Estado active do botão Personalizar." },
+        { "name": "mobileLogoSrc", "type": "string", "default": "'branding/logo-singulai-icon.png'", "description": "Logo mobile (split-ready)." },
+        { "name": "mobileLogoAlt", "type": "string", "default": "'Singulai'", "description": "Alt text do logo mobile." }
+      ],
+      "examples": [
+        "<ds-page-header title=\"Cursos\" icon=\"heroBookOpen\" [breadcrumbs]=\"[{label: 'Ensino'}, {label: 'Cursos'}]\" />"
+      ]
+    },
+    {
+      "name": "SidebarLeftNavComponent",
+      "selector": "ds-sidebar-left-nav",
+      "description": "Sidebar principal collapsible — 5 estados visuais (collapsed 44px / expanded ~280px / item-active / item-default / item-hover). Persiste expanded/collapsed em localStorage. Submenus expansíveis com mutex (apenas 1 aberto por vez).",
+      "tags": ["sidebar", "navigation", "menu", "collapsible", "submenu"],
+      "props": [
+        { "name": "menuItems", "type": "SidebarMenuItem[]", "default": "[]", "description": "Items do menu raiz com submenus." },
+        { "name": "user", "type": "SidebarUser | null", "default": "null", "description": "Usuário logado (footer avatar)." },
+        { "name": "initialState", "type": "SidebarState", "default": "'collapsed'", "description": "Estado inicial. Override do localStorage." },
+        { "name": "logoFullSrc", "type": "string", "default": "'branding/logo-singulai-full.png'", "description": "Logo completo (expanded — split-ready)." },
+        { "name": "logoIconSrc", "type": "string", "default": "'branding/logo-singulai-icon.png'", "description": "Logo ícone (collapsed — split-ready)." },
+        { "name": "logoAlt", "type": "string", "default": "'Singulai'", "description": "Alt do logo (split-ready)." },
+        { "name": "menuToggleExpandedIconSrc", "type": "string", "default": "'branding/icons/icon-menu-expanded.svg'", "description": "Ícone toggle expandido (split-ready)." },
+        { "name": "menuToggleCollapsedIconSrc", "type": "string", "default": "'branding/icons/icon-menu-default.svg'", "description": "Ícone toggle colapsado (split-ready)." },
+        { "name": "userIconSrc", "type": "string", "default": "'branding/icons/menu/user.svg'", "description": "Ícone usuário no footer (split-ready)." }
+      ],
+      "outputs": [
+        { "name": "stateChange", "type": "EventEmitter<SidebarState>" },
+        { "name": "searchClick", "type": "EventEmitter<void>" },
+        { "name": "accountClick", "type": "EventEmitter<void>" },
+        { "name": "submenuItemClick", "type": "EventEmitter<string>" }
+      ],
+      "examples": [
+        "<ds-sidebar-left-nav [menuItems]=\"items\" [user]=\"currentUser()\" (accountClick)=\"openAccount()\" />"
+      ]
+    },
+    {
+      "name": "NavFooterComponent",
+      "selector": "ds-nav-footer",
+      "description": "Bottom navigation mobile com 5 botões (Dashboard / Navegue / Agente IA / Alertas / Conta). Painéis crescem para cima com mutex (apenas 1 aberto por vez). Visível apenas <992px via @media SCSS.",
+      "tags": ["navigation", "mobile", "bottom-nav", "footer", "tab-bar", "panels"],
+      "props": [
+        { "name": "activePanel", "type": "NavFooterPanel | null", "default": "null", "description": "Painel atualmente aberto (mutex)." },
+        { "name": "dashboardActive", "type": "boolean", "default": "false", "description": "Dashboard active (rota = /dashboard)." },
+        { "name": "navegueActive", "type": "boolean", "default": "false", "description": "Navegue active (rota raiz que não /dashboard)." },
+        { "name": "homeIconSrc", "type": "string", "default": "'branding/icons/nav-footer/01-home.svg'", "description": "Ícone Home (split-ready)." },
+        { "name": "navegueIconSrc", "type": "string", "default": "'branding/icons/nav-footer/02-navegue.svg'", "description": "Ícone Navegue (split-ready)." },
+        { "name": "aiIconSrc", "type": "string", "default": "'branding/icons/nav-footer/03-agente-ia.svg'", "description": "Ícone AI (split-ready)." },
+        { "name": "alertasIconSrc", "type": "string", "default": "'branding/icons/nav-footer/04-alertas.svg'", "description": "Ícone Alertas (split-ready)." },
+        { "name": "contaIconSrc", "type": "string", "default": "'branding/icons/nav-footer/05-conta.svg'", "description": "Ícone Conta (split-ready)." }
+      ],
+      "outputs": [
+        { "name": "panelToggle", "type": "EventEmitter<NavFooterPanel>" },
+        { "name": "dashboardClick", "type": "EventEmitter<void>" },
+        { "name": "closePanels", "type": "EventEmitter<void>" }
+      ],
+      "examples": [
+        "<ds-nav-footer page-layout-nav-footer [activePanel]=\"layout.navFooterPanel()\" (panelToggle)=\"layout.togglePanel($event)\" />"
+      ]
+    },
+    {
+      "name": "AiAssistantPanelComponent",
+      "selector": "ds-ai-assistant-panel",
+      "description": "Painel lateral do Agente IA — header com tabs (current/new/chats) + créditos pill + actions (settings, maximize/minimize, close) + timeline de mensagens + action prompts + composer. Modo embedded para projeção em mobile bottom-sheet.",
+      "tags": ["ai", "assistant", "chat", "panel", "agent", "llm"],
+      "props": [
+        { "name": "showTitle", "type": "boolean", "default": "false", "description": "Exibe label 'Agente IA' (true=desktop, false=mobile)." },
+        { "name": "credits", "type": "number", "default": "0", "description": "Saldo de créditos IA na pill." },
+        { "name": "messages", "type": "AiMessage[]", "default": "[]", "description": "Mensagens da timeline." },
+        { "name": "actionPrompts", "type": "string[]", "default": "[]", "description": "Sugestões de prompts clicáveis." },
+        { "name": "activeTab", "type": "AiTab", "default": "'current'", "description": "Tab ativo." },
+        { "name": "hasCurrentChat", "type": "boolean", "default": "true", "description": "Mostra tab 'Chat atual...' closable." },
+        { "name": "currentChatLabel", "type": "string", "default": "'Chat atual...'", "description": "Label do tab atual." },
+        { "name": "maximized", "type": "boolean", "default": "false", "description": "Visual do botão maximize (icon contract vs expand)." },
+        { "name": "embedded", "type": "boolean", "default": "false", "description": "Modo embedded (remove card chrome — para nesting em mobile bottom-sheet)." },
+        { "name": "settingsIconSrc", "type": "string", "default": "'branding/icons/ai-assistant/settings.svg'", "description": "Ícone settings (split-ready)." },
+        { "name": "maximizeIconSrc", "type": "string", "default": "'branding/icons/ai-assistant/maximize.svg'", "description": "Ícone maximize (split-ready)." },
+        { "name": "minimizeIconSrc", "type": "string", "default": "'branding/icons/ai-assistant/minimize.svg'", "description": "Ícone minimize (split-ready)." },
+        { "name": "closeIconSrc", "type": "string", "default": "'branding/icons/ai-assistant/close.svg'", "description": "Ícone close (split-ready)." }
+      ],
+      "examples": [
+        "<ds-ai-assistant-panel page-layout-ai [showTitle]=\"true\" [credits]=\"creditsLeft()\" [messages]=\"chatMessages()\" [actionPrompts]=\"suggestions()\" />"
+      ]
+    },
+    {
+      "name": "SegmentedTabsComponent",
+      "selector": "ds-segmented-tabs",
+      "description": "Tabs segmentados pill-style com items closable opcionais e radius dinâmico baseado em $first/$last. Generic <K> para tipagem das keys (ex: 'day' | 'week' | 'month').",
+      "tags": ["tabs", "segmented", "pills", "filter", "period"],
+      "props": [
+        { "name": "items", "type": "SegmentedTabItem<K>[]", "required": true, "description": "Items dos tabs (key + label + closable opcional)." },
+        { "name": "activeKey", "type": "K | null", "default": "null", "description": "Key do tab ativo." }
+      ],
+      "outputs": [
+        { "name": "tabSelect", "type": "EventEmitter<K>" },
+        { "name": "tabClose", "type": "EventEmitter<K>" }
+      ],
+      "examples": [
+        "<ds-segmented-tabs [items]=\"[{key:'day',label:'Dia'},{key:'week',label:'Semana'}]\" [activeKey]=\"'week'\" (tabSelect)=\"setPeriod($event)\" />"
+      ]
+    },
+    {
+      "name": "StatsbarCardComponent",
+      "selector": "ds-statsbar-card",
+      "description": "Card de KPI para statsbar — title + value + delta (com seta up/down) + ícone neumorphic embutido. 6 variants de cor (success/purple/warning/info/danger/neutral). Polaridade invertida disponível (delta down como positivo).",
+      "tags": ["kpi", "statsbar", "metric", "card", "dashboard"],
+      "props": [
+        { "name": "title", "type": "string", "required": true, "description": "Título do KPI." },
+        { "name": "value", "type": "string | number", "required": true, "description": "Valor principal." },
+        { "name": "delta", "type": "string | null", "default": "null", "description": "Variação (ex: '+12%' ou 'R$ 480')." },
+        { "name": "deltaDirection", "type": "StatsbarCardDeltaDirection", "default": "'up'", "description": "Seta do delta." },
+        { "name": "inversePolarity", "type": "boolean", "default": "false", "description": "Inverte semântica de cor (delta down como positivo)." },
+        { "name": "variant", "type": "StatsbarCardVariant", "default": "'neutral'", "description": "Variant de cor do ícone." },
+        { "name": "iconImageSrc", "type": "string | null", "default": "null", "description": "Path do ícone (ex: 'branding/icons/statsbar/01-revenue.svg')." },
+        { "name": "iconWidth", "type": "number", "default": "22", "description": "Largura intrínseca do SVG (HTML attr para mobile)." },
+        { "name": "iconHeight", "type": "number", "default": "22", "description": "Altura intrínseca do SVG (HTML attr para mobile)." }
+      ],
+      "examples": [
+        "<ds-statsbar-card title=\"Receita\" [value]=\"12480\" delta=\"+12%\" deltaDirection=\"up\" variant=\"success\" iconImageSrc=\"branding/icons/statsbar/01-revenue.svg\" />"
+      ]
+    },
+    {
+      "name": "AiAssistantButtonComponent",
+      "selector": "ds-ai-assistant-button",
+      "description": "Botão de toggle do AI Assistant para o combo do header (32px height). Estado active (panel aberto) com triple-ring neumorphic + bg #EFF3F8.",
+      "tags": ["ai", "button", "toggle", "header", "combo"],
+      "props": [
+        { "name": "ariaLabel", "type": "string", "default": "'Abrir Assistente IA'", "description": "Aria-label." },
+        { "name": "active", "type": "boolean", "default": "false", "description": "AI Assistant panel aberto." },
+        { "name": "sparklesIconSrc", "type": "string", "default": "'branding/icons/sparkles.svg'", "description": "Override do ícone sparkles (split-ready)." }
+      ],
+      "outputs": [
+        { "name": "clicked", "type": "EventEmitter<MouseEvent>" }
+      ],
+      "examples": [
+        "<ds-ai-assistant-button [active]=\"aiState() === 'open'\" (clicked)=\"toggleAi()\" />"
+      ]
+    },
+    {
+      "name": "DarkModeButtonComponent",
+      "selector": "ds-dark-mode-button",
+      "description": "Toggle de tema (light/dark) para o combo do header. Composite SVG com lua + cone de luz rotacionado + 2 estrelas em cruz, todos com filter neumorphic unificado.",
+      "tags": ["theme", "dark-mode", "button", "toggle", "header", "combo"],
+      "props": [
+        { "name": "ariaLabel", "type": "string", "default": "'Alternar tema claro/escuro'", "description": "Aria-label." },
+        { "name": "moonIconSrc", "type": "string", "default": "'branding/icons/moon-vector217.svg'", "description": "Lua principal (split-ready)." },
+        { "name": "moonGlowIconSrc", "type": "string", "default": "'branding/icons/moon-vector.svg'", "description": "Cone de luz (split-ready)." }
+      ],
+      "outputs": [
+        { "name": "clicked", "type": "EventEmitter<MouseEvent>" }
+      ],
+      "examples": [
+        "<ds-dark-mode-button (clicked)=\"themeService.toggle()\" />"
+      ]
+    },
+    {
+      "name": "NotificationsButtonComponent",
+      "selector": "ds-notifications-button",
+      "description": "Botão de sino de notificações para o combo do header (32px). Renderiza apenas o SVG bell com filter neumorphic.",
+      "tags": ["notifications", "bell", "button", "header", "combo"],
+      "props": [
+        { "name": "ariaLabel", "type": "string", "default": "'Notificacoes'", "description": "Aria-label." },
+        { "name": "bellIconSrc", "type": "string", "default": "'branding/icons/bell.svg'", "description": "Override do ícone bell (split-ready)." }
+      ],
+      "outputs": [
+        { "name": "clicked", "type": "EventEmitter<MouseEvent>" }
+      ],
+      "examples": [
+        "<ds-notifications-button (clicked)=\"openNotifications()\" />"
+      ]
+    }
+  ]
+}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * Singulai Design System — MCP Server
+ *
+ * Expoe o catalogo do Design System Singulai (Angular 20, Standalone +
+ * Signals, neumorphic) para AI agents via Model Context Protocol.
+ *
+ * Tools v0.1:
+ *   - list_components()                — array nome+selector+description+tags
+ *   - get_component(name|selector)     — info completa: props tipados, outputs, exemplos
+ *   - search_components(query, limit)  — busca por keyword com score
+ *
+ * Transport: stdio (padrao MCP — clientes spawnam o processo).
+ */
+export {};

package/dist/index.js ADDED Viewed

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+/**
+ * Singulai Design System — MCP Server
+ *
+ * Expoe o catalogo do Design System Singulai (Angular 20, Standalone +
+ * Signals, neumorphic) para AI agents via Model Context Protocol.
+ *
+ * Tools v0.1:
+ *   - list_components()                — array nome+selector+description+tags
+ *   - get_component(name|selector)     — info completa: props tipados, outputs, exemplos
+ *   - search_components(query, limit)  — busca por keyword com score
+ *
+ * Transport: stdio (padrao MCP — clientes spawnam o processo).
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { findComponent, loadCatalog, searchComponents, } from './catalog.js';
+const SERVER_NAME = 'singulai-design-system-mcp';
+const SERVER_VERSION = '0.1.0';
+// Carrega catalogo no boot — falha rapido se JSON invalido
+const catalog = loadCatalog();
+const server = new Server({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ---------------------------------------------------------------------------
+// Formatadores (saida amigavel para AI agents)
+// ---------------------------------------------------------------------------
+function formatComponentSummary(c) {
+    return `- ${c.selector} (${c.name}): ${c.description}`;
+}
+function formatComponentDetail(c) {
+    const lines = [
+        `# ${c.name}`,
+        `**Selector:** \`${c.selector}\``,
+        '',
+        c.description,
+        '',
+        `**Tags:** ${c.tags.join(', ')}`,
+        '',
+        '## Props (@Input)',
+    ];
+    if (c.props.length === 0) {
+        lines.push('_Nenhum @Input declarado._');
+    }
+    else {
+        lines.push('| Nome | Tipo | Default | Descricao |');
+        lines.push('|------|------|---------|-----------|');
+        for (const p of c.props) {
+            const def = p.required ? '_required_' : (p.default ?? '_(sem default)_');
+            const type = '`' + p.type + '`';
+            lines.push(`| \`${p.name}\` | ${type} | ${def} | ${p.description} |`);
+        }
+    }
+    if (c.outputs && c.outputs.length > 0) {
+        lines.push('', '## Outputs (@Output)', '');
+        for (const o of c.outputs) {
+            lines.push(`- \`${o.name}\`: \`${o.type}\``);
+        }
+    }
+    if (c.examples.length > 0) {
+        lines.push('', '## Exemplos de uso', '');
+        for (const ex of c.examples) {
+            lines.push('```html');
+            lines.push(ex);
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Tools registry
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'list_components',
+                description: 'Lista todos os componentes do Singulai Design System com nome, selector e descricao curta. Use quando o usuario pergunta "quais componentes existem" ou "o que tem disponivel no DS".',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'get_component',
+                description: 'Retorna info completa de um componente: descricao, tags, props (@Input) tipados com defaults, outputs (@Output), e exemplos de uso. Use quando o usuario pergunta sobre um componente especifico (ex: "como uso o ds-button" ou "props do FormFieldComponent").',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: {
+                            type: 'string',
+                            description: 'Nome do componente (ex: "ButtonComponent") OU selector (ex: "ds-button"). Case-insensitive.',
+                        },
+                    },
+                    required: ['name'],
+                },
+            },
+            {
+                name: 'search_components',
+                description: 'Busca componentes por palavra-chave em selector, nome, descricao e tags. Use quando o usuario descreve uma necessidade sem saber o nome exato (ex: "preciso de um botao com loading", "componente para tabela", "AI assistant", "form com select").',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Palavras-chave separadas por espaco. Ex: "form select", "ai chat", "kpi dashboard".',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximo de resultados (default 5, max 15).',
+                            minimum: 1,
+                            maximum: 15,
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    switch (name) {
+        case 'list_components': {
+            const lines = [
+                `# ${catalog.design_system.name} (${catalog.design_system.version})`,
+                catalog.design_system.homepage,
+                '',
+                `${catalog.components.length} componentes disponiveis:`,
+                '',
+                ...catalog.components.map(formatComponentSummary),
+                '',
+                '_Use `get_component(name)` para ver props, outputs e exemplos de cada um._',
+            ];
+            return {
+                content: [{ type: 'text', text: lines.join('\n') }],
+            };
+        }
+        case 'get_component': {
+            const queryName = args?.name?.trim();
+            if (!queryName) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Erro: parametro `name` e obrigatorio. Ex: `get_component({ name: "ds-button" })`.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const component = findComponent(catalog, queryName);
+            if (!component) {
+                const suggestions = searchComponents(catalog, queryName, 3);
+                const suggestionText = suggestions.length > 0
+                    ? `\n\nVoce talvez quis dizer:\n${suggestions
+                        .map((s) => `- ${s.component.selector} (${s.component.name})`)
+                        .join('\n')}`
+                    : '\n\nUse `list_components()` para ver todos os componentes disponiveis.';
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Componente '${queryName}' nao encontrado.${suggestionText}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: formatComponentDetail(component) }],
+            };
+        }
+        case 'search_components': {
+            const query = args?.query?.trim();
+            if (!query) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Erro: parametro `query` e obrigatorio. Ex: `search_components({ query: "form select" })`.',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const limitArg = args?.limit;
+            const limit = Math.min(Math.max(limitArg ?? 5, 1), 15);
+            const results = searchComponents(catalog, query, limit);
+            if (results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Nenhum componente correspondeu a "${query}". Use \`list_components()\` para ver todos os componentes disponiveis.`,
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `# Resultados para "${query}" (${results.length} match${results.length > 1 ? 'es' : ''})`,
+                '',
+                ...results.map(({ component, score }) => `**${component.selector}** (${component.name}) — score ${score}\n${component.description}\n_Tags: ${component.tags.join(', ')}_`),
+                '',
+                '_Use `get_component(name)` para ver props, outputs e exemplos de cada um._',
+            ];
+            return {
+                content: [{ type: 'text', text: lines.join('\n\n') }],
+            };
+        }
+        default:
+            throw new Error(`Tool desconhecida: ${name}`);
+    }
+});
+// ---------------------------------------------------------------------------
+// Bootstrap
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log no stderr para nao poluir o stdout (que e o canal MCP JSON-RPC)
+    console.error(`[${SERVER_NAME}] v${SERVER_VERSION} ready (stdio) — ${catalog.components.length} components in catalog`);
+}
+main().catch((error) => {
+    console.error('[fatal]', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAEL,aAAa,EACb,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACjD,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,2DAA2D;AAC3D,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;AAE9B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,cAAc;CACxB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,CAAmB;IACjD,OAAO,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,qBAAqB,CAAC,CAAmB;IAChD,MAAM,KAAK,GAAa;QACtB,KAAK,CAAC,CAAC,IAAI,EAAE;QACb,mBAAmB,CAAC,CAAC,QAAQ,IAAI;QACjC,EAAE;QACF,CAAC,CAAC,WAAW;QACb,EAAE;QACF,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAChC,EAAE;QACF,mBAAmB;KACpB,CAAC;IAEF,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,iBAAiB,CAAC,CAAC;YACzE,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;YAChC,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,CAAC,IAAI,QAAQ,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,IAAI,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACzC,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO;QACL,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,uLAAuL;gBACzL,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;iBACf;aACF;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EACT,iQAAiQ;gBACnQ,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,6FAA6F;yBAChG;qBACF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;aACF;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EACT,qPAAqP;gBACvP,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,qFAAqF;yBACnG;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2CAA2C;4BACxD,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,EAAE;yBACZ;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,KAAK,GAAG;gBACZ,KAAK,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,OAAO,CAAC,aAAa,CAAC,OAAO,GAAG;gBACpE,OAAO,CAAC,aAAa,CAAC,QAAQ;gBAC9B,EAAE;gBACF,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,2BAA2B;gBACvD,EAAE;gBACF,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,sBAAsB,CAAC;gBACjD,EAAE;gBACF,4EAA4E;aAC7E,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,SAAS,GAAI,IAAI,EAAE,IAA2B,EAAE,IAAI,EAAE,CAAC;YAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mFAAmF;yBAC1F;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACpD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;gBAC5D,MAAM,cAAc,GAClB,WAAW,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC,gCAAgC,WAAW;yBACxC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,QAAQ,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;yBAC7D,IAAI,CAAC,IAAI,CAAC,EAAE;oBACjB,CAAC,CAAC,wEAAwE,CAAC;gBAE/E,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,eAAe,SAAS,oBAAoB,cAAc,EAAE;yBACnE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;aACpE,CAAC;QACJ,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,KAAK,GAAI,IAAI,EAAE,KAA4B,EAAE,IAAI,EAAE,CAAC;YAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,2FAA2F;yBAClG;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,EAAE,KAA2B,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAEvD,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAExD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,qCAAqC,KAAK,yEAAyE;yBAC1H;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG;gBACZ,sBAAsB,KAAK,MAAM,OAAO,CAAC,MAAM,SAAS,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG;gBACzF,EAAE;gBACF,GAAG,OAAO,CAAC,GAAG,CACZ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,KAAK,SAAS,CAAC,QAAQ,OAAO,SAAS,CAAC,IAAI,aAAa,KAAK,KAAK,SAAS,CAAC,WAAW,YAAY,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnI;gBACD,EAAE;gBACF,4EAA4E;aAC7E,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,KAAK,CACX,IAAI,WAAW,MAAM,cAAc,oBAAoB,OAAO,CAAC,UAAU,CAAC,MAAM,wBAAwB,CACzG,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json ADDED Viewed

@@ -0,0 +1,53 @@
+{
+  "name": "@dgplsoares/singulai-ds-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing the Singulai Design System (Angular 20) to AI agents — Claude Desktop, Claude Code, Cursor, Continue.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "singulai-ds-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && cp -r src/data dist/",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "design-system",
+    "angular",
+    "neumorphism",
+    "singulai",
+    "claude",
+    "ai-agents"
+  ],
+  "author": "Diogo Soares <https://www.linkedin.com/in/dgsoares/>",
+  "license": "MIT",
+  "homepage": "https://design.singulai.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dgplsoares/singulai-design-system-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dgplsoares/singulai-design-system-mcp/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}