GPA Backend Test Analyst MCP

Servidor MCP especializado em análise de qualidade de testes backend para o e-commerce do Grupo Pão de Açúcar (GPA).

Atua como um Engenheiro Sênior de Backend na sustentação de microsserviços, cobrindo análise de cobertura, engenharia reversa de módulos sem documentação, mapeamento de arquiteturas descentralizadas e geração de suites de testes completas.

Índice

• Pré-requisitos

• Instalação

• Como rodar

• Integração com VS Code

• Tools disponíveis

• Resources disponíveis

• Prompt Templates

• Exemplos de uso

• Métricas de qualidade

Pré-requisitos

• Node.js >= 18

• VS Code com extensão GitHub Copilot Chat

Instalação

git clone <url-do-repositorio>
cd McpAutomation
npm install
npm run build

Como rodar

Modo desenvolvimento (sem build)

npm run dev

Modo produção

npm run build
npm start

Testar visualmente com o MCP Inspector

npx @modelcontextprotocol/inspector node dist/gpa-mcp-server.js

Acesse http://localhost:6274 para explorar todas as tools, resources e prompts com uma interface gráfica.

Integração com VS Code

O arquivo .vscode/mcp.json já está configurado. Com o build gerado (dist/gpa-mcp-server.js), o servidor é detectado automaticamente pelo VS Code.

1. Abra o GitHub Copilot Chat (Ctrl+Alt+I)

2. Selecione o modo Agent

3. O servidor gpa-backend-test-analyst estará disponível

Configuração manual (outros clientes MCP)

{
  "mcpServers": {
    "gpa-backend-test-analyst": {
      "command": "node",
      "args": ["caminho/para/dist/gpa-mcp-server.js"],
      "env": {
        "GPA_ENVIRONMENT": "sustentacao",
        "TARGET_COVERAGE": "100"
      }
    }
  }
}

Tools disponíveis

analyze_test_coverage

Analisa o relatório de cobertura de um serviço. Identifica gaps, classifica riscos de negócio por criticidade e sugere casos de teste para fechar os gaps.

reverse_engineer_module

Analisa código sem documentação e gera descrição funcional, contratos de entrada/saída, dependências identificadas e documentação pronta (Javadoc/JSDoc).

map_decentralized_architecture

Mapeia dependências entre microsserviços, identifica Single Points of Failure (SPOFs), fluxos síncronos/assíncronos e gera estratégia de testes por camada com diagrama Mermaid.

generate_test_suite

Gera suite de testes completa com 100% de cobertura de branches: happy path, edge cases, cenários de erro, testes de contrato e mocks configurados.

diagnose_test_failure

Diagnostica falhas em testes existentes: identifica causa raiz, classifica o tipo (flaky, regression, environment, test bug, production bug) e gera o código corrigido.

generate_documentation

Gera documentação técnica a partir do código nos formatos JSDoc, Javadoc, OpenAPI 3.0, ADR, README ou Wiki.

Resources disponíveis

Prompt Templates

Exemplos de uso

Analisar cobertura de um serviço

Analise a cobertura do checkout-service com meta de 100%.
[cole o relatório LCOV aqui]

Fazer engenharia reversa de um método

Analise esse código Java do payment-service sem documentação e gere o Javadoc completo.
[cole o código aqui]

Mapear dependências de um fluxo de compra

Mapeie os serviços: cart-service, checkout-service, payment-service, order-service
Ponto de entrada: checkout-service

Diagnosticar um teste falhando na pipeline

O teste should_complete_order_when_payment_approved está falhando com esse erro:
[cole o stack trace aqui]

Métricas de qualidade

Domínios cobertos

catalog · cart · checkout · payment · order · fulfillment · customer

Integrações: gateways de pagamento · ERPs · WMS · CDN · Kafka · RabbitMQ · Antifraude

Padrões: REST · gRPC · Event-driven · BFF · CQRS · Saga