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 (ex.: Kiro) como um Power, habilitando o agente a gerar código Angular correto sem inventar APIs.

Estrutura

mcp-server/         ← código-fonte do MCP Server (pacote npm publicado)
  src/
    index.ts        ← entrypoint do servidor MCP
    handlers.ts     ← implementação das ferramentas
    data/           ← regras e guias técnicos (Markdown + JSON estático)
  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
  POWER.md          ← manifesto do Power para o Kiro
  mcp.json          ← configuração local do MCP Server (não commitar com caminho absoluto)
HOW_TO_USE.md       ← guia de instalação e uso local

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/mcp-server && 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 mcp-server/dist/. Veja o HOW_TO_USE.md para instruções completas de configuração no Kiro.

Ferramentas expostas pelo MCP Server

| Ferramenta | Descrição | | ------------------------------- | ----------------------------------------------------------------- | | 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_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.