MCP QA Engineer SDET

Servidor MCP com ferramentas especializadas em QA de software. Conecte em qualquer IDE ou cliente compatível com o Model Context Protocol e tenha acesso a análise de User Stories, estratégia de testes, BDD/Gherkin, testes de contrato (Pact), integração (Testcontainers), performance (k6), segurança (OWASP) e CI/CD.

Pré-requisitos

Node.js 18+
npm 9+
Git

Instalação

# 1. Clonar ou entrar na pasta
cd mcp-testing

# 2. Instalar dependências
npm install

# 3. Compilar TypeScript
npm run build

Após o build, o servidor estará disponível em dist/index.js.

Para desenvolvimento sem build:

npm run dev   # usa tsx — não requer compilação

Ferramentas disponíveis (tools)

Tool	Descrição
`analyze_user_story`	Análise completa de User Story: decomposição, critérios, cenários por camada, mapa de riscos, dados de teste, checklist
`generate_test_strategy`	Estratégia de testes para o sistema: pirâmide adaptada, ferramentas, CI/CD, metas de cobertura, roadmap
`create_gherkin_scenarios`	Cenários BDD em Gherkin: happy path, negativos, edge cases, Esquema do Cenário, tabelas de dados
`design_contract_tests`	Contratos Pact (CDC): interações, provider states, matchers, versionamento, can-i-deploy
`design_integration_tests`	Testes de integração: Testcontainers, WireMock, setup/teardown, concorrência, observabilidade
`generate_performance_plan`	Plano k6 completo: smoke/load/stress/spike/soak, thresholds, análise de resultados
`security_test_checklist`	Checklist OWASP Top 10 por tipo de feature + headers, SAST/DAST, critérios de aceitação
`review_test_code`	Revisão de código de teste: anti-patterns, isolamento, asserções, mocks, cobertura
`troubleshoot_flaky_test`	Diagnóstico de flaky tests: hipóteses, passos, correções com código, política de prevenção
`generate_ci_pipeline`	Pipeline CI/CD com stages, paralelismo, cache, cobertura mínima, gates de qualidade
`quality_checklist`	Checklists por artefato: user story, plano, caso de teste, código, contrato, suíte, bug report

Recursos disponíveis (resources)

URI	Descrição
`qa://pyramid`	Pirâmide de testes: distribuição, objetivos, anti-patterns
`qa://tool-matrix`	Matriz de seleção de ferramentas por linguagem e necessidade
`qa://gherkin-template`	Template completo de Feature File BDD
`qa://k6-templates`	Scripts k6 prontos: smoke, load, stress, spike, soak
`qa://glossary`	Glossário de termos QA/SDET

Prompts disponíveis

Prompt	Descrição
`analyze-story`	Sessão de análise de User Story
`start-tdd`	Sessão TDD guiada (Red → Green → Refactor)
`write-test-plan`	Elaboração de plano de testes
`debug-failure`	Diagnóstico de falha em teste ou ambiente

Configuração por IDE

VS Code (GitHub Copilot Agent)

Crie ou edite .vscode/mcp.json na raiz do seu workspace:

{
  "servers": {
    "qa-sdet": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/mcp-testing/dist/index.js"]
    }
  }
}

Requer GitHub Copilot com suporte a MCP (VS Code 1.99+). Ative em Settings → GitHub Copilot → MCP.

Alternativa via settings.json do usuário (escopo global):

{
  "mcp": {
    "servers": {
      "qa-sdet": {
        "type": "stdio",
        "command": "node",
        "args": ["C:/caminho/absoluto/mcp-testing/dist/index.js"]
      }
    }
  }
}

Cursor

Crie .cursor/mcp.json na raiz do projeto:

{
  "mcpServers": {
    "qa-sdet": {
      "command": "node",
      "args": ["./mcp-testing/dist/index.js"]
    }
  }
}

Ou configure globalmente em Cursor → Settings → MCP via interface gráfica.

Claude Desktop

Windows — edite %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "qa-sdet": {
      "command": "node",
      "args": ["C:\\Users\\SeuUsuario\\caminho\\mcp-testing\\dist\\index.js"]
    }
  }
}

macOS — edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "qa-sdet": {
      "command": "node",
      "args": ["/Users/seuusuario/caminho/mcp-testing/dist/index.js"]
    }
  }
}

Linux — edite ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "qa-sdet": {
      "command": "node",
      "args": ["/home/seuusuario/caminho/mcp-testing/dist/index.js"]
    }
  }
}

Reinicie o Claude Desktop após editar o arquivo.

Windsurf (Codeium)

Edite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "qa-sdet": {
      "command": "node",
      "args": ["/caminho/absoluto/mcp-testing/dist/index.js"]
    }
  }
}

Continue.dev

Edite ~/.continue/config.json (ou config.yaml):

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": ["/caminho/absoluto/mcp-testing/dist/index.js"]
        }
      }
    ]
  }
}

Zed

Edite o arquivo de configuração do Zed (~/.config/zed/settings.json):

{
  "context_servers": {
    "qa-sdet": {
      "command": {
        "path": "node",
        "args": ["/caminho/absoluto/mcp-testing/dist/index.js"]
      }
    }
  }
}

Qualquer cliente MCP (genérico)

O servidor usa transporte stdio padrão. Configure com:

{
  "command": "node",
  "args": ["/caminho/absoluto/para/mcp-testing/dist/index.js"],
  "transport": "stdio"
}

Exemplos de uso

No chat do IDE

Analise esta User Story:
"Como usuário, quero resetar minha senha para recuperar acesso à conta"

O assistente chamará analyze_user_story automaticamente e retornará a análise estruturada.

Crie cenários Gherkin para o fluxo de checkout com os critérios:
- Usuário com carrinho não vazio pode finalizar compra
- Pagamento com cartão inválido é rejeitado com mensagem
- Frete é calculado pelo CEP do endereço de entrega

Gere um plano de performance para POST /api/orders com SLA p95 < 400ms

Revise este código de teste:
[colar o código]

Usando os prompts pré-construídos

Em IDEs que suportam prompts MCP (como Claude Desktop e Cursor):

/analyze-story — análise de User Story
/start-tdd — sessão TDD
/write-test-plan — plano de testes
/debug-failure — diagnóstico de falha

Verificar se o servidor está funcionando

# Executar diretamente e verificar output de inicialização
node dist/index.js
# Deve exibir em stderr: "MCP QA SDET Server v2.0.0 pronto."

# Ou via npm
npm start

Desenvolvimento

# Modo desenvolvimento (sem compilação)
npm run dev

# Compilar para produção
npm run build

# Watch mode (recompila ao salvar)
npx tsc --watch

Troubleshooting

"Cannot find module" ao executar

Execute npm run build antes de npm start. O diretório dist/ precisa existir.

Servidor não aparece no IDE

Verifique o caminho absoluto no arquivo de configuração
Confirme que Node.js 18+ está instalado: node --version
Confirme que o build foi gerado: ls dist/index.js
Reinicie o IDE após alterar a configuração

Erros de TypeScript no build

npx tsc --noEmit   # verificar erros sem gerar arquivos

Timeout ao conectar

Adicione timeout na configuração do cliente:

{
  "command": "node",
  "args": ["/caminho/dist/index.js"],
  "timeout": 10000
}

Estrutura do projeto

mcp-testing/
├── src/
│   └── index.ts          # Servidor MCP completo
├── dist/                 # Gerado pelo build (não versionar)
│   └── index.js
├── package.json
├── tsconfig.json
├── SYSTEM_PROMPT.md      # Prompt de sistema QA SDET Senior
└── README.md

Tecnologias

Model Context Protocol SDK
TypeScript 5
Node.js 18+

Desenvolvido por Michael Maia — QA Engineer SDET
LinkedIn · GitHub · QA Playground