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