Skip to main content
Glama
Clearon Content Archive MCP

Clearon Content Archive MCP

by kwgoodwin

Clearon Content Archive MCP

追記専用のコンテンツレコード、検証済みの公開履歴、ソーシャルフォロースルー、取得に適したメタデータのためのMCPサーバー。

それ自体は何も公開せずに、来歴とワークフローの状態を保持するように設計されています。

行うこと

  • スラッグごとに追記専用のコンテンツイベントを保存します。

  • 高速読み取りのためのマテリアライズドスナップショットを維持します。

  • 検証済みのWordPressおよびソーシャル成果を記録します。

  • 過去の履歴を書き換えずにソースの修正を追跡します。

  • 重複検索、インベントリ、フォロースルーレポートを提供します。

  • イベント履歴が保存済みスナップショットと完全に一致するかを検証します。

Related MCP server: What Brandon Thinks Chat MCP

行わないこと

  • WordPressやソーシャルプラットフォームへの公開は行いません。

  • publish とマークされたペイロードを、実際に公開された証拠としては扱いません。

  • 法的または編集上の真実性の判断は行いません。

  • 設定されたワークスペース外のアーティファクトパスを許可しません。

要件

  • Node.js 20 以降

  • stdioサーバーを起動できるローカルMCPクライアント

インストール

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

MCPクライアントのセットアップ

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"
      }
    }
  }
}

CLEARON_CONTENT_ARCHIVE_WORKSPACE を使用して、ローカルアーティファクトパスが検証される基準となるルートを定義します。アーカイブの保存場所は CLEARON_CONTENT_ARCHIVE_ROOT で上書きします。

ストレージ

デフォルトでは、アーカイブデータはリポジトリ外のユーザーデータディレクトリに保存されます。

  • 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

各レコードは records/<slug>/ の下に配置され、以下を保存します。

  • events.jsonl

  • snapshot.json

検証と修復

verify_archive_record は読み取り専用です。再構築されたイベント履歴を保存済みスナップショットと比較し、一致するかどうかを報告します。

自動修復は、新しいイベントを追記する前に、以前の部分書き込みから回復する必要がある変更パスに限定されます。

パッケージ監査CLIは次のとおりです。

npm run audit

検証の失敗を黙ってスキップするのではなく、明示的に報告します。

推奨ワークフロー

  1. ローカルのドラフトパッケージを登録します。

  2. 検証済みの公開結果または更新結果を追記します。

  3. ブロッカーやスキップを含む、LinkedInおよびXの結果を追記します。

  4. 来歴の修正を新しいイベントとして記録します。

  5. 関連する作業の下書き前に、重複検索ツールと検索ツールを使用します。

  6. 監査中に、インベントリおよび不完全フォロースルー出力を使用します。

  7. 移行後、手動リカバリ後、または破損が疑われる場合に検証を実行します。

ツール

  • 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

URLの取り扱い

保存されるURLは http または https を使用する必要があり、URL内の認証情報は拒否されます。

アーカイブ履歴は追記専用であるため、クエリ文字列にトークンやその他の秘密情報を含む機密URLを書き込まないようにしてください。

開発

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