Clearon Source Audit MCP

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

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

Что он делает

• Привязывает каждый аудит к точному отпечатку (fingerprint) ревизии статьи.

• Фиксирует классификации источников и сопоставления утверждений с источниками.

• Сверяет прямые цитаты с полученным текстом источника.

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

• Формирует неизменяемые JSON-отчёты для проверенной ревизии.

Related MCP server: CiteGuard

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

• Не определяет юридическую правильность или фактическую достоверность.

• Не публикует и не изменяет внешние системы.

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

• Не превращает признанные предупреждения в обоснование по существу.

Требования

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

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

Установка

cd tools/clearon-source-audit-mcp
npm install
npm test
npm run smoke

Настройка MCP-клиента

Пример stdio-конфигурации:

{
  "mcpServers": {
    "clearon-source-audit": {
      "command": "node",
      "args": ["/absolute/path/to/clearon-source-audit-mcp/server.mjs"]
    }
  }
}

Если вы хотите хранить данные аудита в определённом месте, задайте CLEARON_SOURCE_AUDIT_ROOT в окружении клиента.

Хранение данных

По умолчанию данные аудита хранятся вне репозитория в пользовательском каталоге данных:

• macOS: ~/Library/Application Support/clearon-source-audit-mcp/source-audits

• Linux: ${XDG_DATA_HOME:-~/.local/share}/clearon-source-audit-mcp/source-audits

• Windows: %APPDATA%\\clearon-source-audit-mcp\\source-audits

Переопределите это расположение, задав CLEARON_SOURCE_AUDIT_ROOT.

Каждый аудит хранит:

• audit.json

• article.txt

• reports/*.json

Файлы записываются с правами доступа только для владельца, если это поддерживает платформа хоста.

Рекомендуемый порядок действий

1. Создайте или получите точный текст статьи для аудита.

2. Вычислите его SHA-256-отпечаток.

3. Вызовите create_source_audit.

4. Вызовите register_source для каждого источника.

5. Вызовите record_claim_mapping для проверяемых фактических или правовых утверждений.

6. Запустите run_mechanical_checks.

7. Исправьте в статье слабые утверждения, отсутствующие выдержки, несовпадения цитат и процессуальные предупреждения.

8. Если текст статьи изменился, создайте новый аудит для новой ревизии.

9. Вызовите generate_source_report.

10. Используйте acknowledge_finding только тогда, когда человек действительно просмотрел и принял предупреждение.

Инструменты

• get_server_health

• create_source_audit

• get_source_audit

• list_source_audits

• register_source

• record_claim_mapping

• run_mechanical_checks

• generate_source_report

• acknowledge_finding

Сетевое поведение

Проверки доступности URL выполняются по явному согласию (opt-in). run_mechanical_checks и generate_source_report по умолчанию устанавливают check_urls в false.

Когда эта проверка включена, сервер выполняет ограниченные проверки достижимости по HTTP(S) и рассматривает сбои только как предупреждения. Перед каждым запросом (включая перенаправления) он отклоняет локальные/частные DNS-ответы и привязывает соединение к проверенным публичным адресам, чтобы снизить риск DNS-rebinding. Это проверка для удобства, а не решение о доверии и не замена мер контроля исходящего трафика на уровне хоста.

Разработка

npm test
npm run smoke
npm run syntax
node --check server.mjs