Clearon Content Archive MCP

用于仅追加内容记录、已验证发布历史、社交媒体后续跟进以及便于检索的元数据的 MCP 服务器。

它旨在保留来源信息和工作流状态，而自身不发布任何内容。

它能做什么

• 按 slug 存储仅追加的内容事件。

• 维护物化快照以支持快速读取。

• 记录已验证的 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