Skip to main content
Glama
Clearon Content Archive MCP

Clearon Content Archive MCP

by kwgoodwin

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: What Brandon Thinks Chat MCP

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

Available Tools

16 tools
approve_voice_exampleB

Explicitly mark an exact archived excerpt as an approved Clearon voice example; never infers approval.

Inputs: slug (required), excerpt (required), expected_revision (required), note, +1 more.

compare_payload_to_live_stateC

Compare a workspace-contained WordPress payload with a caller-supplied verified live-state response.

Inputs: slug (required), live_state (required), payload_path.

find_content_overlapB

Rank potentially overlapping archived content using disclosed lexical overlap; requires editorial review.

Inputs: slug (required), limit.

find_content_recordB

Find exact archive records by content slug, WordPress post ID, or recorded publication/social URL.

Inputs: url, slug, post_id.

generate_content_inventoryA

Generate a current structured inventory of archive, publication, social, topic, correction, and voice-example counts.

Inputs: no named parameters.

get_content_recordA

Read a content snapshot and, by default, its complete append-only event history.

Inputs: slug (required), include_events.

get_server_healthB

Report archive health, storage root, and non-publishing safety boundaries.

Inputs: no named parameters.

list_incomplete_follow_throughA

List records missing verified WordPress publication, featured-image verification, or completed LinkedIn/X outcomes.

Inputs: no named parameters.

list_update_candidatesA

List mechanically stale publications, post-publication source corrections, and image-verification gaps; does not make editorial recommendations.

Inputs: older_than_days.

record_publicationB

Record a verified WordPress outcome. This tool never publishes and does not infer live state from a payload.

Inputs: slug (required), status (required), expected_revision (required), url, +10 more.

record_social_resultA

Record a LinkedIn or X outcome, including published URLs, schedules, queues, or blockers. This tool never posts.

Inputs: slug (required), status (required), platform (required), expected_revision (required), +7 more.

record_source_correctionA

Append a provenance correction without rewriting the earlier archive history.

Inputs: slug (required), field (required), reason (required), previous_value (required), +4 more.

register_content_packageB

Create an append-only Clearon content record with local artifacts and editorial retrieval metadata.

Inputs: slug (required), title (required), content_type (required), topics, +6 more.

search_content_archiveC

Search archived titles, summaries, openings, topics, jurisdictions, and terminology.

Inputs: query, topic, jurisdiction.

update_content_artifactsC

Append a metadata or local-artifact update using optimistic revision control.

Inputs: slug (required), expected_revision (required), note, title, +7 more.

verify_archive_recordA

Replay an append-only event log and confirm whether it matches the stored snapshot without repairing it.

Inputs: slug (required), include_rebuilt_snapshot.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools target distinct resources and actions, such as searching, exact lookup, and registering content. The main ambiguity is between list_incomplete_follow_through and list_update_candidates, which both surface records needing verification or correction, but their descriptions largely clarify the intended focus.

    Naming Consistency5/5

    All tool names use a consistent lower_snake_case verb_noun pattern, such as get_content_record, record_publication, and approve_voice_example. Even the longer compound names like compare_payload_to_live_state and list_incomplete_follow_through follow the same predictable action-first convention.

    Tool Count4/5

    The server has 16 tools, which is slightly above the typical well-scoped range, but each tool appears to support a distinct archival lifecycle concern. The count is not excessive given the breadth of content, publication, social, correction, and voice-example workflows being covered.

    Completeness4/5

    The tool set covers the core content archive lifecycle: register, read, search, update, verify, and append publication/social/correction outcomes. Minor gaps exist, such as no explicit unpublish or approval-revocation tool, but the append-only design and existing verification tools make those acceptable omissions.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers