Clearon Content Archive MCP
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 smokeMCPクライアントのセットアップ
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-archiveLinux:
${XDG_DATA_HOME:-~/.local/share}/clearon-content-archive-mcp/content-archiveWindows:
%APPDATA%\\clearon-content-archive-mcp\\content-archive
各レコードは records/<slug>/ の下に配置され、以下を保存します。
events.jsonlsnapshot.json
検証と修復
verify_archive_record は読み取り専用です。再構築されたイベント履歴を保存済みスナップショットと比較し、一致するかどうかを報告します。
自動修復は、新しいイベントを追記する前に、以前の部分書き込みから回復する必要がある変更パスに限定されます。
パッケージ監査CLIは次のとおりです。
npm run audit検証の失敗を黙ってスキップするのではなく、明示的に報告します。
推奨ワークフロー
ローカルのドラフトパッケージを登録します。
検証済みの公開結果または更新結果を追記します。
ブロッカーやスキップを含む、LinkedInおよびXの結果を追記します。
来歴の修正を新しいイベントとして記録します。
関連する作業の下書き前に、重複検索ツールと検索ツールを使用します。
監査中に、インベントリおよび不完全フォロースルー出力を使用します。
移行後、手動リカバリ後、または破損が疑われる場合に検証を実行します。
ツール
get_server_healthregister_content_packageget_content_recordsearch_content_archivefind_content_recordupdate_content_artifactsrecord_publicationrecord_social_resultrecord_source_correctionapprove_voice_examplecompare_payload_to_live_statefind_content_overlaplist_incomplete_follow_throughlist_update_candidatesgenerate_content_inventoryverify_archive_record
URLの取り扱い
保存されるURLは http または https を使用する必要があり、URL内の認証情報は拒否されます。
アーカイブ履歴は追記専用であるため、クエリ文字列にトークンやその他の秘密情報を含む機密URLを書き込まないようにしてください。
開発
npm test
npm run smoke
npm run syntax
npm run auditAvailable Tools
16 toolsapprove_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
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
Preserve public web pages as signed, timestamped evidence packages, then verify them, compare versions and monitor pages for changes.
Issue & verify signed (ed25519), hash-chained, timestamped provenance receipts for agent actions.
Privacy-first document verification anchored to the public ledger.
Prove a web page or document existed on a date: public SHA-256 registry anchored in Bitcoin. Free.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables users to create frozen, auditable snapshots of selected Markdown or text-layer PDFs and perform read-only, verifiable local searches with SQLite FTS5/BM25, preserving source hashes, schemas, and page/line anchors.82Apache 2.0
- AlicenseAqualityCmaintenanceEnables privacy-aware, deterministic, read-only chat analysis through tools for briefs, aggregate interaction signals, evidence-aware claim audits, and canonical resource discovery.242MIT
- AlicenseBqualityCmaintenanceEnables deterministic RSS 2.0 feed publishing and lifecycle management, including immutable entry IDs, corrections, retractions, archiving, content-addressed media assets, and semantic search over active entries.16MIT
- AlicenseNot gradedqualityCmaintenanceEnables capturing web evidence, freezing content-addressed snapshots, and comparing research agents on the same sources with traceable access and quotations.1MIT