scanverdict

scanverdict

你会仅凭一个 AI 的判断就对那块板钻芯吗？scanverdict 是一个本地 stdio 桥接程序，可连接托管的 GroundTruth MCP 服务，为地下扫描团队提供第二双眼睛：两个不同的 AI 模型分别独立读取 GPR、定位、管道或 X 射线扫描结果——第一个负责解读，第二个则会收到提示词，尝试反驳第一个模型的判断；此外，它还提供一款面向技工、以语音为先的报价生成器和价格查询工具。

安全第一：read_scan 的结果仅供参考，绝不能作为切割、钻芯或挖掘的许可。任何钻芯或挖掘作业前，都必须由持证技术人员审核并签字确认。两个模型的解读若有分歧，只会提高危险项的严重程度，绝不会悄悄将其判定为安全。

托管端点为 https://gtfi.ai/mcp（无需身份验证）。此软件包在本地作为 stdio MCP 服务运行，并以 JSON-RPC 将每次工具调用转发到该端点。设置 GROUNDTRUTH_MCP_URL 环境变量即可指定其他地址。

上游文档说明的限制：每次调用 read_scan 都会运行两个视觉模型，每位调用者每天最多可调用 2 次（另有全局每日上限）；draft_estimate 每位调用者每小时最多可调用 5 次，每天最多可调用 20 次。API 不收取任何费用。

CLI

npx @reneturcios/scanverdict read-scan https://example.com/scan.jpg --discipline gpr --field-note "NW corner"
npx @reneturcios/scanverdict draft-estimate "Replaced the panel, 85 feet of conduit, 8 can lights, 16 hours" --trade electrical
npx @reneturcios/scanverdict pricing
npx @reneturcios/scanverdict --version

输出为上游结果的 JSON。退出代码：成功时为 0，运行时错误（包括上游失败）时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/scanverdict mcp

MCP 客户端配置：

{
  "mcpServers": {
    "scanverdict": {
      "command": "npx",
      "args": ["-y", "@reneturcios/scanverdict", "mcp"]
    }
  }
}

工具

• read_scan — 两个不同的 AI 模型分别独立读取地下扫描结果：第一个负责解读，第二个则会收到提示词，尝试反驳第一个模型的判断。结果仅供参考；任何钻芯或挖掘作业前，都必须由持证技术人员审核并签字确认。
  • image_url（字符串，必填）— 指向 JPEG 或 PNG 的公开 https 链接，最大 8 MB
  • discipline（字符串，可选）— 可选值为 gpr、locate、pipe、xray、milestone；默认值为 gpr
  • field_note（字符串，可选）— 技术人员在现场所述内容；仅作为背景信息，绝不能用于排除图像中显示的危险
• draft_estimate — 将简单明了的技工工作描述转换为按项目列出的报价，价格符合美国市场的实际水平。
  • job_description（字符串，必填）— 简明英文工作描述
  • trade（字符串，可选）— 可选值为 electrical、plumbing、hvac、general
• get_pricing — 两款产品的当前套餐。免费且不限量。不接受任何参数。

Docker

docker run -i ghcr.io/cloudcorprecords/scanverdict
docker run --rm ghcr.io/cloudcorprecords/scanverdict pricing

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios