Clearon Source Audit MCP

MCP-Server für revisionsgebundene Quellenprüfung, Zitatabgleich und Berichte zur Evidenzkontrolle vor der Veröffentlichung.

Es ist darauf ausgelegt, genau das zu bewahren, was geprüft wurde. Es veröffentlicht keine Artikel, entscheidet nicht über die Wahrheit und ersetzt kein rechtliches oder redaktionelles Urteilsvermögen.

Was es tut

• Bindet jede Prüfung an einen exakten Fingerabdruck der Artikelrevision.

• Erfasst Quellenklassifikationen und Zuordnungen von Behauptungen zu Quellen.

• Überprüft wörtliche Zitate anhand des abgerufenen Quelltexts.

• Kennzeichnet verfahrensrechtliche Sprachrisiken, etwa wenn Behauptungen als Entscheidungen formuliert werden.

• Erzeugt unveränderliche JSON-Berichte für die geprüfte Revision.

Related MCP server: CiteGuard

Was es nicht tut

• Es stellt weder rechtliche Richtigkeit noch faktische Wahrheit fest.

• Es veröffentlicht oder verändert keine externen Systeme.

• Es behandelt einen Abruffehler nicht als Beweis dafür, dass eine Quelle falsch ist.

• Es wandelt quittierte Warnungen nicht in inhaltliche Belege um.

Voraussetzungen

• Node.js 20 oder neuer

• Ein lokaler MCP-Client, der einen stdio-Server starten kann

Installation

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

MCP-Client-Einrichtung

Beispielkonfiguration für stdio:

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

Wenn Sie die Prüfdaten an einem bestimmten Ort ablegen möchten, setzen Sie CLEARON_SOURCE_AUDIT_ROOT in der Client-Umgebung.

Speicherung

Standardmäßig werden die Prüfdaten außerhalb des Repositorys in einem Benutzerdatenverzeichnis gespeichert:

• 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

Sie können diesen Speicherort mit CLEARON_SOURCE_AUDIT_ROOT überschreiben.

Jede Prüfung speichert:

• audit.json

• article.txt

• reports/*.json

Dateien werden mit Berechtigungen geschrieben, die nur dem Eigentümer Zugriff gewähren, sofern die Host-Plattform dies unterstützt.

Empfohlener Arbeitsablauf

1. Erstellen oder beschaffen Sie den exakten Artikeltext, der geprüft werden soll.

2. Berechnen Sie seinen SHA-256-Fingerabdruck.

3. Rufen Sie create_source_audit auf.

4. Rufen Sie für jede Quelle register_source auf.

5. Rufen Sie record_claim_mapping für prüfbare faktische oder rechtliche Behauptungen auf.

6. Führen Sie run_mechanical_checks aus.

7. Beheben Sie schwache Behauptungen, fehlende Auszüge, Zitatabweichungen und verfahrensrechtliche Warnungen im Artikel.

8. Wenn sich der Artikeltext ändert, erstellen Sie für die neue Revision eine neue Prüfung.

9. Rufen Sie generate_source_report auf.

10. Verwenden Sie acknowledge_finding nur, wenn ein Mensch die Warnung tatsächlich geprüft und akzeptiert hat.

Werkzeuge

• 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

Netzwerkverhalten

URL-Verfügbarkeitsprüfungen sind optional (Opt-in). run_mechanical_checks und generate_source_report setzen check_urls standardmäßig auf false.

Wenn diese aktiviert sind, führt der Server begrenzte HTTP(S)-Erreichbarkeitsprüfungen durch und behandelt Fehler ausschließlich als Warnungen.

Vor jeder Anfrage (einschließlich Weiterleitungen) verwirft er lokale/private DNS-Antworten und bindet die Verbindung an die validierten öffentlichen Adressen, um die Angriffsfläche für DNS-Rebinding zu verringern.

Dies ist eine Bequemlichkeitsprüfung, keine Vertrauensentscheidung und kein Ersatz für Egress-Kontrollen auf Host-Ebene.

Entwicklung

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