Clearon Content Archive MCP

Servidor MCP para registros de contenido de solo adición, historial de publicación verificado, seguimiento en redes sociales y metadatos pensados para la recuperación.

Está diseñado para preservar la procedencia y el estado del flujo de trabajo sin publicar nada por sí mismo.

Qué hace

• Almacena eventos de contenido de solo adición por slug.

• Mantiene una instantánea materializada para lecturas rápidas.

• Registra resultados verificados de WordPress y redes sociales.

• Hace seguimiento de las correcciones de fuente sin reescribir el historial anterior.

• Proporciona búsqueda de solapamientos, inventario e informes de seguimiento.

• Verifica si el historial de eventos coincide exactamente con la instantánea almacenada.

Related MCP server: tatastu-proof

Qué no hace

• No publica en WordPress ni en plataformas sociales.

• No trata una carga útil marcada como publish como prueba de publicación en vivo.

• No hace determinaciones legales ni editoriales de veracidad.

• No permite rutas de artefactos fuera del espacio de trabajo configurado.

Requisitos

• Node.js 20 o superior

• Un cliente MCP local que pueda iniciar un servidor stdio

Instalación

cd tools/clearon-content-archive-mcp
npm install
npm test
npm run smoke

Configuración del cliente MCP

Ejemplo de configuración stdio:

{
  "mcpServers": {
    "clearon-content-archive": {
      "command": "node",
      "args": ["/absolute/path/to/clearon-content-archive-mcp/server.mjs"],
      "env": {
        "CLEARON_CONTENT_ARCHIVE_WORKSPACE": "/absolute/path/to/workspace"
      }
    }
  }
}

Utilice CLEARON_CONTENT_ARCHIVE_WORKSPACE para definir la raíz contra la cual se validan las rutas de artefactos locales. Sobrescriba la ubicación de almacenamiento del archivo con CLEARON_CONTENT_ARCHIVE_ROOT.

Almacenamiento

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

• macOS: ~/Library/Application Support/clearon-content-archive-mcp/content-archive

• Linux: ${XDG_DATA_HOME:-~/.local/share}/clearon-content-archive-mcp/content-archive

• Windows: %APPDATA%\\clearon-content-archive-mcp\\content-archive

Cada registro se encuentra bajo records/<slug>/ y almacena:

• events.jsonl

• snapshot.json

Verificación y reparación

verify_archive_record es de solo lectura. Compara el historial de eventos reconstruido con la instantánea almacenada e informa si coinciden.

La reparación automática está reservada para rutas de mutación que necesitan recuperarse de una escritura parcial anterior antes de añadir un nuevo evento.

La CLI de auditoría del paquete es:

npm run audit

Informa explícitamente de los fallos de verificación en lugar de omitirlos silenciosamente.

Flujo de trabajo recomendado

1. Registre el paquete de borrador local.

2. Añada los resultados verificados de publicación o actualización.

3. Añada los resultados de LinkedIn y X, incluidos bloqueos u omisiones.

4. Registre las correcciones de procedencia como nuevos eventos.

5. Utilice las herramientas de búsqueda y solapamiento antes de redactar trabajo relacionado.

6. Utilice el inventario y la salida de seguimiento incompleto durante las auditorías.

7. Ejecute la verificación después de una migración, recuperación manual o si se sospecha corrupción.

Herramientas

• get_server_health

• register_content_package

• get_content_record

• search_content_archive

• find_content_record

• update_content_artifacts

• record_publication

• record_social_result

• record_source_correction

• approve_voice_example

• compare_payload_to_live_state

• find_content_overlap

• list_incomplete_follow_through

• list_update_candidates

• generate_content_inventory

• verify_archive_record

Manejo de URLs

Las URL almacenadas deben usar http o https, y se rechazan las credenciales en las URL.

Debido a que el historial del archivo es de solo adición, evite escribir URL sensibles con tokens u otros secretos en las cadenas de consulta.

Desarrollo

npm test
npm run smoke
npm run syntax
npm run audit