angular-components-mcp

MCP Server que fornece a agentes de IA conhecimento especializado sobre a biblioteca @seniorsistemas/angular-components, permitindo geração de código Angular correto e alinhado ao SDS.

Publica o pacote npm @seniorsistemas/angular-components-mcp.

O que é

Este repositório implementa um Model Context Protocol (MCP) server com ferramentas que expõem:

• Metadados de 70+ componentes Angular (inputs, outputs, exemplos de import)
• Tipos e propriedades do DynamicForm, extraídos diretamente do código-fonte TypeScript
• Regras de UX e guias técnicos de uso por componente

O servidor é consumido por agentes de IA como um MCP Server, compatível com GitHub Copilot, Claude Code, Kiro e qualquer cliente que suporte o protocolo MCP.

Compatibilidade de versões

A versão do angular-components-mcp é publicada automaticamente pelo semantic-release a partir das mensagens de commit, então a sua major não corresponde à major do @seniorsistemas/angular-components. A correspondência entre as duas é mantida em um mapa interno (src/compatibilityMap.ts):

| angular-components-mcp (major) | angular-components (major suportada) | |---------------------------------|----------------------------------------| | 1.x | 19.x |

Se a versão de @seniorsistemas/angular-components instalada no projeto não corresponder à major suportada pela versão do MCP em uso, a tool get_usage_guide retorna automaticamente um aviso de incompatibilidade. Consulte a tabela acima (ou o mapa em src/compatibilityMap.ts) para saber qual versão do MCP instalar para a sua versão da biblioteca.

Ao passar a suportar uma nova major do angular-components, adicione uma nova entrada em src/compatibilityMap.ts e publique uma nova major deste MCP (commit com BREAKING CHANGE:).

Estrutura

src/
  index.ts               ← entrypoint do servidor MCP
  handlers.ts            ← implementação das ferramentas
  data/
    usage-guide.md       ← guia de uso obrigatório (retornado pela tool get_usage_guide)
    ux-rules.md          ← regras cross-component
    component-rules/     ← regras de UX por componente
    component-technical/ ← guias técnicos por componente
scripts/
  generate/              ← scripts que leem o fonte do angular-components e geram JSONs de metadados
  build/                 ← scripts de pós-build
kiro-power/              ← artefatos do Kiro Power (apenas manifesto — instruções estão no MCP)
HOW_TO_USE.md            ← guia de instalação e uso para cada agente de IA

Dependência de build

Os scripts de geração de metadados precisam do código-fonte não compilado do repositório angular-components. Clone os dois repositórios lado a lado:

algum-diretorio/
  angular-components-mcp/   ← este repositório
  angular-components/        ← biblioteca de componentes

Build local

# 1. Instalar dependências da biblioteca (necessário para o compilador TypeScript)
cd angular-components && npm install && cd ..

# 2. Instalar dependências do MCP Server
cd angular-components-mcp && npm install

# 3. Buildar com a env var apontando para o fonte da biblioteca
ANGULAR_COMPONENTS_SRC=../../angular-components/projects/angular-components npm run build

O build gera o servidor em dist/. Veja o HOW_TO_USE.md para instruções completas de configuração em cada agente de IA.

Ferramentas expostas pelo MCP Server

| Ferramenta | Descrição | | ------------------------------- | --------------------------------------------------------------------------------------- | | get_usage_guide | Guia de uso obrigatório: verificação de versão, fluxo de chamadas e regras de compliance | | get_components | Lista componentes por categoria ou palavra-chave | | get_component_details | API completa de um componente (inputs, outputs, imports) | | get_dynamic_form_types | Tipos de campos e estruturas do DynamicForm | | detect_required_providers | Detecta providers necessários para uma configuração de formulário | | get_ux_rules | Regras cross-component (tokens Tailwind, loading states, etc.) | | get_component_rules_index | Lista componentes com regras de UX detalhadas | | get_component_ux_rules | Regras de UX de um componente específico | | get_component_technical_index | Lista componentes com guia técnico | | get_component_technical_guide | Guia técnico de um componente (padrões, exemplos, erros comuns) |

Suporte

Time SDS.