Simple Data Comparator MCP

Simple Data Comparator MCP

Conjunto de herramientas simple para realizar comparaciones de datos JSON, XML, XLSX, CSV y texto en formato Actual-Expected con diferentes opciones.

Documentación

Referencia orientada a agentes para el servidor MCP simple-data-comparator-mcp. Cada comparador compara un valor actual contra una plantilla esperada y devuelve aprobado/fallido con líneas de diferencia estructuradas en caso de fallo.

Herramientas

Herramienta MCP	Documentación	Úsala cuando
compare-json	json-comparator.md	Comparar respuestas de API JSON, objetos de configuración o datos estructurados
compare-xml	xml-comparator.md	Comparar documentos XML, cargas SOAP o archivos de configuración
compare-csv	csv-comparator.md	Comparar exportaciones o informes CSV tabulares
compare-xlsx	xlsx-comparator.md	Comparar hojas de libros de Excel
compare-text	text-comparator.md	Comparación de texto exacta línea por línea (registros, salida de texto plano)

Forma de respuesta común

Todas las herramientas devuelven contenido MCP con esta estructura:

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

• Aprobado: isError: false, el texto es Validation passed.
• Fallido: isError: true, el texto incluye Validation failed. y líneas de diferencia (excepto el comparador de texto, que no expone detalles de diff a través de MCP)

Flujo de trabajo del agente

1. Elige la herramienta que coincida con el formato de datos que necesitas comparar.
2. Prepara las entradas — JSON/XML/CSV/texto como cadenas; XLSX como rutas de archivo del espacio de trabajo (p. ej. Templates/test/1.xlsx) o base64.
3. Llama a la herramienta MCP — para Excel usa compare-xlsx con las rutas de archivo actual y template.
4. Lee isError — si true, analiza las líneas de diferencia para explicar qué divergió.
5. Aplica opciones cuando sea necesario (p. ej. strictMode para JSON, includeColumns para CSV, ignoreRowOrder para conjuntos de filas sin ordenar).

Descubrir herramientas en tiempo de ejecución

Usa el descubrimiento de herramientas MCP (tools/list) para obtener esquemas en vivo. Los nombres de las herramientas son estables: validate-json, validate-xml, validate-csv, validate-xlsx, validate-text.

Ejecución

Compila e inicia el servidor MCP stdio:

npm run build
npm start

El servidor se comunica a través de stdin/stdout. Los registros se escriben en stderr para no interferir con los mensajes del protocolo MCP.

Configuración de Cursor

Añade esto a tu configuración de MCP de Cursor (.cursor/mcp.json):

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

Reemplaza la ruta con la ruta de tu proyecto local. Ejecuta npm run build antes de iniciar el servidor.