mcp-server-ngzorro by velrys - MCP Server

MCP Server NG-ZORRO

Servidor MCP (Model Context Protocol) que expõe ferramentas para consulta inteligente da documentação NG-ZORRO (Ant Design for Angular) via GitHub API com cache eficiente, operando em modo STDIO (JSON‑RPC 2.0) compatível com clientes MCP.

✨ Destaques

Fluxo enxuto: extração de contexto → recuperação de documentação
Ferramentas tipadas com Zod + validação
Modo STDIO pronto para clientes MCP (Claude / VS Code / Cursor / scripts customizados)
Facilmente extensível para novas tools de busca/listagem

🧰 Ferramentas Disponíveis

Tool	Descrição
`extract_ngzorro_topic`	Gera prompt estruturado (component, topics, intent, subtarefas)
`query_ngzorro_document`	Busca documentação e exemplos oficiais do componente (simples/complexo)

Outras ferramentas utilitárias antigas foram removidas temporariamente para simplificar a superfície inicial.

⚡ Uso Rápido

1. Executar sem instalar

npx mcp-server-ngzorro

2. Instalar globalmente

npm install -g mcp-server-ngzorro
mcp-server-ngzorro

3. Execução STDIO direta (debug/manual)

npm run build
node build/index.js --stdio

O processo aguardará mensagens JSON‑RPC 2.0 via stdin e responderá via stdout.

Configuração VS Code (exemplo)

Crie ~/.vscode/mcp.json:

{
  "servers": {
    "mcp-server-ngzorro": {
      "command": "npx",
      "args": ["-y", "mcp-server-ngzorro", "mcp"]
    }
  }
}

Nota: O argumento final "mcp" é opcional. Ele existe para compatibilidade com clientes que enviam um subcomando explícito (padrão semelhante ao @angular/cli). Se seu cliente não precisar, pode remover.

Windows (cmd) Config (Cursor / VS Code)

Se estiver no Windows e o cliente exigir uso de cmd:

{
  "mcpServers": {
    "mcp-server-ngzorro": {
      "command": "npx",
      "args": ["-y", "mcp-server-ngzorro"]
    }
  }
}

Também aqui o mcp final é opcional.

👩‍💻 Desenvolvimento

git clone https://github.com/velrys/mcp-server-ngzorro.git
cd mcp-server-ngzorro
npm install
npm run build        # compila para ./build
node build/index.js --stdio  # inicia em modo stdio
npm start            # build + inspector interativo

🧪 Exemplo (Agente)

mode: agent
tools: ['extract_ngzorro_topic', 'query_ngzorro_document']
description: 'Trazer docs e exemplo básico'
---
Preciso exibir uma tabela paginada com filtros server-side. Traga a doc relevante e um trecho mínimo.

🤝 Contribuição

🔒 Repositório Público com Fluxo Rigoroso

Todas as mudanças devem ser feitas via Pull Request com aprovação obrigatória. Leia o completo.

🚀 Fluxo Rápido:

# 1. Fork o repositório
# 2. Clone e prepare
git clone https://github.com/SEU_USUARIO/mcp-server-ngzorro.git
cd mcp-server-ngzorro && npm install

# 3. Crie branch para sua mudança
git checkout -b feature/minha-contribuicao

# 4. Desenvolva, teste e commit
npm run build && npm run lint
git commit -m "feat: minha contribuição"

# 5. Push e abra PR
git push origin feature/minha-contribuicao

📋 Requisitos:

✅ Build e lint passando
✅ PR template preenchido
✅ Code review e aprovação
✅ Commits seguindo Conventional Commits

Ver para detalhes completos.

🔒 Segurança

Sem coleta ou armazenamento de dados do usuário.

🚨 Vulnerabilidades:

Não abra issue pública
Reporte via
Email: erivelton.silva106@gmail.com

✅ Boas Práticas:

Não commitar tokens
Usar GITHUB_TOKEN apenas para rate limits
Manter dependências atualizadas (npm audit)

Ver para processo completo.

📄 Licença

Nota: Arquivos internos históricos foram simplificados; este README é a fonte principal.

🙏 Créditos

NG-ZORRO Team
Comunidade Model Context Protocol

Pronto para explorar? npx mcp-server-ngzorro