Clearon Content Archive MCP

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

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

行うこと

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

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

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

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

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

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

Related MCP server: tatastu-proof

行わないこと

• 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