Clearon Source Audit MCP

Servidor MCP para la revisión de fuentes vinculada a revisiones, la comparación de citas y los informes de control de evidencia previos a la publicación.

Está diseñado para preservar exactamente lo que fue auditado. No publica artículos, no decide la verdad ni reemplaza el criterio legal o editorial.

Qué hace

• Vincula cada auditoría a una huella exacta de revisión del artículo.

• Registra clasificaciones de fuentes y asignaciones de afirmaciones a fuentes.

• Verifica las citas directas contra el texto de la fuente recuperado.

• Señala riesgos de lenguaje procesal, como presentar alegaciones como conclusiones.

• Genera informes JSON inmutables para la revisión auditada.

Related MCP server: CiteGuard

Qué no hace

• No determina la corrección legal ni la verdad fáctica.

• No publica ni modifica sistemas externos.

• No trata el fallo de recuperación como prueba de que una fuente es falsa.

• No convierte las advertencias reconocidas en respaldo sustantivo.

Requisitos

• Node.js 20 o superior

• Un cliente MCP local que pueda iniciar un servidor stdio

Instalación

cd tools/clearon-source-audit-mcp
npm install
npm test
npm run smoke

Configuración del cliente MCP

Ejemplo de configuración stdio:

{
  "mcpServers": {
    "clearon-source-audit": {
      "command": "node",
      "args": ["/absolute/path/to/clearon-source-audit-mcp/server.mjs"]
    }
  }
}

Si desea almacenar los datos de auditoría en una ubicación específica, establezca CLEARON_SOURCE_AUDIT_ROOT en el entorno del cliente.

Almacenamiento

De forma predeterminada, los datos de auditoría se almacenan fuera del repositorio en un directorio de datos de usuario:

• macOS: ~/Library/Application Support/clearon-source-audit-mcp/source-audits

• Linux: ${XDG_DATA_HOME:-~/.local/share}/clearon-source-audit-mcp/source-audits

• Windows: %APPDATA%\\clearon-source-audit-mcp\\source-audits

Anule esa ubicación con CLEARON_SOURCE_AUDIT_ROOT.

Cada auditoría almacena:

• audit.json

• article.txt

• reports/*.json

Los archivos se escriben con permisos de solo propietario cuando la plataforma anfitriona lo permite.

Flujo de trabajo recomendado

1. Cree u obtenga el texto exacto del artículo que va a auditar.

2. Calcule su huella SHA-256.

3. Llame a create_source_audit.

4. Llame a register_source para cada fuente.

5. Llame a record_claim_mapping para las afirmaciones fácticas o legales comprobables.

6. Ejecute run_mechanical_checks.

7. Corrija las afirmaciones débiles, los extractos faltantes, las discrepancias de citas y las advertencias procesales en el artículo.

8. Si el texto del artículo cambia, cree una nueva auditoría para la nueva revisión.

9. Llame a generate_source_report.

10. Use acknowledge_finding solo cuando una persona haya revisado y aceptado realmente una advertencia.

Herramientas

• get_server_health

• create_source_audit

• get_source_audit

• list_source_audits

• register_source

• record_claim_mapping

• run_mechanical_checks

• generate_source_report

• acknowledge_finding

Comportamiento de red

Las comprobaciones de disponibilidad de URL son opcionales. run_mechanical_checks y generate_source_report tienen check_urls establecido en false de forma predeterminada.

Cuando está habilitado, el servidor realiza comprobaciones acotadas de accesibilidad HTTP(S) y trata los fallos solo como advertencias. Antes de cada solicitud (incluidas las redirecciones), rechaza las respuestas DNS locales/privadas y fija la conexión a las direcciones públicas validadas para reducir la exposición a ataques de DNS rebinding. Esto es una comprobación de conveniencia, no una decisión de confianza ni un reemplazo de los controles de salida a nivel de host.

Desarrollo

npm test
npm run smoke
npm run syntax
node --check server.mjs