npm package: @seniorsistemas/angular-components-mcp
Description: Model Context Protocol server for Senior Sistemas Angular Components
Latest version: 1.0.0

# 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)](https://modelcontextprotocol.io/) 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](https://kiro.dev/)) 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`](https://git.senior.com.br/arquitetura/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

```bash
# 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](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](https://teams.microsoft.com/l/team/19%3AcZ2A01zJnLo1SY9z_Zgu_0rg2X66NtTnuWk9E23RV7M1%40thread.tacv2/conversations?groupId=bb0edbc3-b313-418e-9f97-3477c42a50d5&tenantId=62c7b02d-a95c-498b-9a7f-6e00acab728d)**.