Manual Tests MCP Server

Manual Tests MCP Server

Servidor MCP de gerenciamento de casos de teste manuais baseado em YAML com 11 ferramentas abrangentes para fluxos de trabalho de automação de testes.

Visão Geral

Manual Tests MCP Server é um servidor Model Context Protocol (MCP) que simplifica os fluxos de trabalho de testes manuais. Ele gerencia casos de teste em formato YAML, suportando todo o ciclo de vida do teste, desde o rastreamento de execução até a geração de relatórios.

🎯 Início Rápido para Agentes de IA

Novo neste servidor MCP? Comece com as ferramentas de descoberta de fluxo de trabalho:

# Essential first steps - run these in order:
manual_test_workflow()    # Learn workflow patterns
manual_test_help()        # Get tool usage examples  
manual_test_schema()      # Understand data structures

Essas ferramentas irão guiá-lo por todos os fluxos de trabalho e padrões de uso disponíveis.

Principais Recursos

• 11 Ferramentas Abrangentes - Validação, análise, listagem, criação, inicialização, gerenciamento de resultados, geração de relatórios, limpeza, ajuda, fluxos de trabalho e esquemas
• Casos de Teste Baseados em YAML - Gerenciamento e validação estruturados de casos de teste
• Filtragem Avançada - Capacidades avançadas de filtragem e busca para casos de teste e resultados
• Criação Baseada em Modelos - Criação de casos de teste com múltiplos modelos integrados
• Substituição de Variáveis - Gerenciamento flexível de ambientes de teste por meio de substituição dinâmica de variáveis
• Gerenciamento de Resultados - Análise de resultados de teste, geração de relatórios e limpeza

Ferramentas Disponíveis

1. manual_test_validate - Validação de estrutura e sintaxe de casos de teste YAML
2. manual_test_parse - Análise de casos de teste com substituição de variáveis e processamento de conteúdo
3. manual_test_list - Listagem de casos de teste com capacidades avançadas de filtragem e ordenação
4. manual_test_create - Criação de novos casos de teste usando modelos integrados
5. manual_test_init - Inicialização da estrutura de projeto de testes manuais
6. manual_test_results_list - Filtragem e listagem do diretório de resultados de teste
7. manual_test_results_report - Geração abrangente de relatórios de execução de testes
8. manual_test_results_clean - Limpeza do diretório de resultados de teste com base em critérios
9. manual_test_help - Informações abrangentes de ajuda para todas as ferramentas
10. manual_test_workflow - Informações sobre fluxos de trabalho e padrões de uso recomendados
11. manual_test_schema - Especificações de estrutura e esquema YAML/JSON

Primeiros Passos

🚀 Primeiros Passos - Essencial para Novos Usuários

Antes de usar qualquer outra ferramenta, comece com estas ferramentas de descoberta de fluxo de trabalho:

// 1. Get comprehensive help for all 11 tools
manual_test_help()

// 2. Learn recommended workflows and usage patterns  
manual_test_workflow()

// 3. Understand YAML/JSON schemas and variable substitution
manual_test_schema()

Por que começar aqui?

• manual_test_help fornece exemplos detalhados de uso para todas as 11 ferramentas
• manual_test_workflow mostra padrões de fluxo de trabalho comprovados e estratégias de integração
• manual_test_schema fornece as especificações completas de estrutura

Essas três ferramentas contêm toda a orientação necessária para usar este servidor MCP de forma eficaz. Sempre consulte a ferramenta de fluxo de trabalho primeiro - isso economizará tempo e garantirá que você siga as melhores práticas.

Uso

Configuração MCP

Para usar com Claude Code ou outros clientes compatíveis com MCP, adicione o seguinte à sua configuração MCP:

{
  "mcpServers": {
    "manual-tests": {
      "command": "npx",
      "args": ["github:70-10/manual-tests-mcp"]
    }
  }
}

Primeiros Passos - Comece Aqui!

🎯 Antes de fazer qualquer outra coisa, execute estas ferramentas de descoberta:

1. manual_test_workflow - Aprenda os padrões de fluxo de trabalho recomendados
2. manual_test_help - Obtenha exemplos detalhados de uso para todas as ferramentas
3. manual_test_schema - Entenda os requisitos de estrutura YAML/JSON

Fluxo de Trabalho Básico (Após Aprender com a Ferramenta de Fluxo de Trabalho)

1. Inicialização do Projeto - Crie a estrutura do projeto e metadados com manual_test_init
2. Criação de Casos de Teste - Gere casos de teste baseados em modelos com manual_test_create
3. Validação - Verifique a estrutura YAML com manual_test_validate
4. Gerenciamento de Execução - Pesquise casos de teste com base em condições com manual_test_list
5. Geração de Relatórios - Crie relatórios abrangentes de resultados de teste com manual_test_results_report

💡 Dica Profissional: A ferramenta de fluxo de trabalho (manual_test_workflow) fornece 4 padrões diferentes de fluxo de trabalho com sequências específicas de ferramentas. Sempre verifique primeiro!

Substituição de Variáveis

Você pode usar valores dinâmicos em casos de teste:

• {{today}} - Data atual (YYYY-MM-DD)
• {{timestamp}} - Carimbo de data/hora atual
• {{environments.production}} - URL do ambiente
• {{test_data.users.valid_user.username}} - Dados de teste

Desenvolvimento

Construção e Testes

# Build TypeScript
npm run build

# Run all tests (252 tests)
npm test

# Run with coverage
npm test:coverage

# Development mode with auto-rebuild
npm run dev

Licença

MIT