MCP Server Test Suite

Given: Request com formato correto:
  {
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {...},
    "id": 1
  }
When: Enviado ao servidor
Then:
  - Parseado corretamente
  - Response com id correspondente
  - Sem erros de parsing

Given: Request malformado:
  - Faltando "jsonrpc": "2.0"
  - ID inválido
  - Method não string
When: Enviado
Then:
  - Error response retornado
  - Code: -32600 (Invalid Request)
  - Mensagem clara

Given: Notification (sem id):
  {
    "jsonrpc": "2.0",
    "method": "initialized",
    "params": {}
  }
When: Enviado
Then:
  - Processado
  - Sem response esperada
  - Operação completa

Given: Multiple requests no mesmo payload:
  [req1, req2, req3]
When: Enviado
Then:
  - Todos processados
  - Array de responses
  - Ordem preservada (por id)

Given: Server ativo
When: tools/list enviado
Then:
  - Lista de tools retornada
  - Schema para cada tool
  - Nomes, descrições
  - Parâmetros documentados

Given: Tool "search_context" disponível
When: tools/call executado com:
  {
    "name": "search_context",
    "arguments": {"query": "auth", "top_k": 5}
  }
Then:
  - Ferramenta invocada
  - Resultado retornado
  - Content no formato correto

Given: Tool espera top_k: integer
When: Enviado top_k: "string"
Then:
  - Error retornado
  - Code: -32602 (Invalid params)
  - Mensagem sobre tipo esperado

Given: Tool requer "query" obrigatório
When: Enviado sem "query"
Then:
  - Error de parâmetro obrigatório
  - Descrição clara
  - Sugestão de correção

Given: Simple request
When: Enviado
Then:
  - Response em < 100ms
  - Sem overhead desnecessário
  - Rápido parsing e serialização

Given: 10 requests simultâneos
When: Todos enviados
Then:
  - Todos processados
  - Response para cada um
  - Latência p95 < 200ms

Given: Request com payload de 10MB
When: Enviado
Then:
  - Aceito (se sob limite)
  - Processado corretamente
  - Sem memory leak

Given: Connection ativa
When: Network intermittent
Then:
  - Detecta desconexão
  - Reconnect automático
  - Estado preservado (se possível)

Given: Tool falha durante execução
When: Exception lançada
Then:
  - Error response gerado
  - Cliente avisado
  - Server continua operacional

Given: Tool indisponível
When: Chamado
Then:
  - Error específico retornado
  - Server não crashes
  - Outras tools funcionam

# Testes MCP
go test -v ./tests/mcp-server/...

# Com JSON-RPC conformance
go test -v -run JSONRPCCompliance ./tests/mcp-server/...

# Load test
go test -v -bench=. ./tests/mcp-server/bench_test.go

# Com race detection
go test -v -race ./tests/mcp-server/...