Clearon Content Archive MCP

MCP-Server für Append-only-Inhaltsdatensätze, verifizierte Veröffentlichungshistorie, Follow-through in sozialen Netzwerken und abruffreundliche Metadaten.

Es ist darauf ausgelegt, Provenienz und Workflow-Zustand zu bewahren, ohne selbst etwas zu veröffentlichen.

Was es tut

• Speichert Append-only-Inhaltsereignisse pro slug.

• Pflegt einen materialisierten Snapshot für schnelle Lesezugriffe.

• Dokumentiert verifizierte WordPress- und Social-Media-Ergebnisse.

• Erfasst Quellkorrekturen, ohne die frühere Historie umzuschreiben.

• Bietet Überlappungssuche, Inventar und Follow-through-Berichterstattung.

• Überprüft, ob die Ereignishistorie exakt mit dem gespeicherten Snapshot übereinstimmt.

Related MCP server: tatastu-proof

Was es nicht tut

• Es veröffentlicht nicht auf WordPress oder Social-Media-Plattformen.

• Es behandelt einen als publish markierten Payload nicht als Nachweis einer tatsächlichen Veröffentlichung.

• Es trifft keine rechtlichen oder redaktionellen Wahrheitsfeststellungen.

• Es erlaubt keine Artefaktpfade außerhalb des konfigurierten Workspaces.

Anforderungen

• Node.js 20 oder neuer

• Ein lokaler MCP-Client, der einen stdio-Server starten kann

Installation

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

MCP-Client-Einrichtung

Beispielkonfiguration für 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"
      }
    }
  }
}

Verwenden Sie CLEARON_CONTENT_ARCHIVE_WORKSPACE, um das Wurzelverzeichnis festzulegen, gegen das lokale Artefaktpfade validiert werden. Überschreiben Sie den Archivspeicherort mit CLEARON_CONTENT_ARCHIVE_ROOT.

Speicherung

Standardmäßig werden die Archivdaten außerhalb des Repositorys in einem Benutzerdatenverzeichnis gespeichert:

• 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

Jeder Datensatz liegt unter records/<slug>/ und speichert:

• events.jsonl

• snapshot.json

Verifizierung und Reparatur

verify_archive_record ist schreibgeschützt. Es vergleicht die neu aufgebaute Ereignishistorie mit dem gespeicherten Snapshot und meldet, ob sie übereinstimmen.

Automatische Reparatur ist Mutationspfaden vorbehalten, die sich vor dem Anhängen eines neuen Ereignisses von einem unvollständigen vorherigen Schreibvorgang erholen müssen.

Die Paket-Audit-CLI lautet:

npm run audit

Sie meldet Verifizierungsfehler explizit, anstatt sie stillschweigend zu überspringen.

Empfohlener Workflow

1. Registrieren Sie das lokale Entwurfspaket.

2. Hängen Sie verifizierte Veröffentlichungs- oder Aktualisierungsergebnisse an.

3. Hängen Sie LinkedIn- und X-Ergebnisse an, einschließlich Blockern oder Skips.

4. Erfassen Sie Provenienzkorrekturen als neue Ereignisse.

5. Nutzen Sie Überlappungs- und Suchtools, bevor Sie verwandte Arbeiten entwerfen.

6. Nutzen Sie Inventar- sowie Ausgaben zu unvollständigem Follow-through bei Audits.

7. Führen Sie die Verifizierung nach Migration, manueller Wiederherstellung oder bei Verdacht auf Datenbeschädigung aus.

Tools

• 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

Umgang mit URLs

Gespeicherte URLs müssen http oder https verwenden, und URL-Zugangsdaten werden abgelehnt.

Da die Archivhistorie append-only ist, vermeiden Sie es, sensible URLs mit Tokens oder anderen Geheimnissen in Query-Strings zu schreiben.

Entwicklung

npm test
npm run smoke
npm run syntax
npm run audit