Simple Data Comparator MCP

Simple Data Comparator MCP

Conjunto simples de ferramentas para realizar comparação de dados JSON, XML, XLSX, CSV e texto no formato Actual-Expected com diferentes opções.

Documentação

Referência orientada a agentes para o servidor MCP simple-data-comparator-mcp. Cada comparador compara um valor atual com um modelo esperado e retorna aprovado/reprovado com linhas de diferença estruturadas em caso de falha.

Ferramentas

Ferramenta MCP	Doc	Uso quando
compare-json	json-comparator.md	Comparar respostas de API JSON, objetos de configuração ou dados estruturados
compare-xml	xml-comparator.md	Comparar documentos XML, payloads SOAP ou arquivos de configuração
compare-csv	csv-comparator.md	Comparar exportações CSV tabulares ou relatórios
compare-xlsx	xlsx-comparator.md	Comparar planilhas de pastas de trabalho do Excel
compare-text	text-comparator.md	Comparação exata de texto linha por linha (logs, saída simples)

Formato comum de resposta

Todas as ferramentas retornam conteúdo MCP com esta estrutura:

{
  "content": [{ "type": "text", "text": "<result message>" }],
  "isError": true | false
}

• Aprovado: isError: false, o texto é Validation passed.
• Reprovado: isError: true, o texto inclui Validation failed. e linhas de diferença (exceto o comparador de texto, que não expõe detalhes de diff via MCP)

Fluxo de trabalho do agente

1. Escolha a ferramenta que corresponda ao formato de dados que você precisa comparar.
2. Prepare as entradas — JSON/XML/CSV/texto como strings; XLSX como caminhos de arquivo do workspace (ex.: Templates/test/1.xlsx) ou base64.
3. Chame a ferramenta MCP — para Excel use compare-xlsx com os caminhos de arquivo actual e template.
4. Leia isError — se true, analise as linhas de diferença para explicar o que divergiu.
5. Aplique opções quando necessário (ex.: strictMode para JSON, includeColumns para CSV, ignoreRowOrder para conjuntos de linhas não ordenados).

Descobrindo ferramentas em tempo de execução

Use a descoberta de ferramentas MCP (tools/list) para obter esquemas ao vivo. Os nomes das ferramentas são estáveis: validate-json, validate-xml, validate-csv, validate-xlsx, validate-text.

Execução

Compile e inicie o servidor MCP stdio:

npm run build
npm start

O servidor se comunica via stdin/stdout. Os logs são gravados em stderr para não interferirem nas mensagens do protocolo MCP.

Configuração do Cursor

Adicione isto às suas configurações MCP do Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "simple-data-comparator-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ee_will_i/simple-data-comparator-mcp"
      ]
    }
  }
}

Substitua o caminho pelo caminho do seu projeto local. Execute npm run build antes de iniciar o servidor.