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