Clearon Source Audit MCP

リビジョンに紐づいたソースレビュー、引用照合、公開前のエビデンス管理レポートのためのMCPサーバー。

監査された内容を正確に保持するように設計されています。記事を公開したり、真偽を判断したり、法的・編集上の判断を置き換えたりするものではありません。

機能

• 各監査を、記事リビジョンの正確なフィンガープリントに紐付けます。

• ソースの分類と、主張からソースへのマッピングを記録します。

• 取得したソーステキストに対して直接引用を検証します。

• 申し立てを判示として記載するなどの手続き上の文言リスクをフラグ付けします。

• 監査されたリビジョンについて、不変のJSONレポートを生成します。

Related MCP server: CiteGuard

対象外

• 法的な正当性や事実の真偽を判断するものではありません。

• 外部システムへの公開や変更を行うものではありません。

• 取得の失敗をソースが虚偽である証拠として扱いません。

• 認識済みの警告を実質的な裏付けに変換するものではありません。

要件

• Node.js 20 以降

• stdioサーバーを起動できるローカルMCPクライアント

インストール

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の到達可能性チェックはオプトインです。run_mechanical_checks と generate_source_report は check_urls をデフォルトで false にします。

有効にすると、サーバーは制限付きのHTTP(S)到達可能性チェックを実行し、失敗を警告としてのみ扱います。各リクエスト（リダイレクトを含む）の前に、ローカル/プライベートDNS応答を拒否し、接続を検証済みの公開アドレスに固定することで、DNSリバインディングへの露出を低減します。これは便宜的なチェックであり、信頼の判断やホストレベルのエグレス制御の代替ではありません。

開発

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