Clearon Content Archive MCP

MCP-сервер для неизменяемых записей контента, проверенной истории публикаций, результатов в социальных сетях и удобных для поиска метаданных.

Он предназначен для сохранения сведений о происхождении и состояния рабочего процесса, ничего не публикуя самостоятельно.

Что он делает

• Хранит события контента в режиме append-only для каждого slug.

• Ведёт материализованный снимок для быстрого чтения.

• Записывает проверенные результаты WordPress и социальных сетей.

• Отслеживает исправления источников без переписывания более ранней истории.

• Предоставляет поиск пересечений, инвентаризацию и отчётность о выполнении последующих действий.

• Проверяет, точно ли история событий соответствует сохранённому снимку.

Related MCP server: tatastu-proof

Что он не делает

• Он не публикует в WordPress или социальные платформы.

• Он не рассматривает полезную нагрузку, помеченную publish, как доказательство фактической публикации.

• Он не выносит юридических или редакционных заключений об истинности.

• Он не допускает пути к артефактам за пределами настроенной рабочей области.

Требования

• Node.js 20 или новее

• Локальный MCP-клиент, который может запускать stdio-сервер

Установка

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 с учётными данными отклоняются.

Поскольку история архива неизменяема (append-only), не записывайте чувствительные URL с токенами или другими секретами в строках запроса.

Разработка

npm test
npm run smoke
npm run syntax
npm run audit