Privi Verify

Privi Verify MCP

一个 MCP 服务，让 AI Agent 能够查询制造批次的来源，以及其记录是否在事后被篡改；使用 x402 在 Base 上以 USDC 按次付费。

兼容所有 MCP 客户端：Claude、ChatGPT、Cursor、VS Code 和自定义 Agent。

在线（测试网）： https://privi-verify.onrender.com/mcp · 演示批次 DEMO-STEEL-0001、DEMO-FOOD-0001

由 Privi World Co（密歇根州休伦港）构建，作为面向 Agent 的 Privi ChainFlow 服务。

工具

工具	价格	功能
privi_pricing	免费	列出工具、价格、网络和收款钱包
privi_lookup_fingerprint	免费	检查记录指纹（来自标签、证书或文档）是否存在
privi_verify_lot	$0.01	批次摘要：产品、首个和最新的保管事件、召回状态、记录完整性
privi_chain_of_custody	$0.05	完整的有序事件历史记录，包括指纹和完整性检查
privi_record_event	API 密钥	制造商追加事件：received、produced、inspected、shipped、transferred、recalled

价格通过环境变量设置。

如何确保记录可信

每个事件的指纹都是其内容加上同一批次中上一个事件的指纹计算出的 SHA-256。修改或删除任何过去的事件都会破坏其后所有事件的指纹，两个验证工具都会准确报告链条断裂的位置。

每个批次的最新指纹每隔几分钟就会锚定到 Privi 区块链上（参见“链上检查点”），因此任何人都可以在不信任 Privi 的情况下进行验证。

链上检查点

服务每 5 分钟将每个发生变更的批次的最新指纹通过 Privi Anchor 锚定到 Privi 区块链上。审计结果包含 onchain_checkpoint：锚定位置、交易和 Merkle 证明，以及任何人都可以调用的 anchor_verify。如果存储的历史记录与锚定内容不再匹配，即使所有本地哈希都已重新计算且彼此一致，审计也会失败。设置 PRIVI_ANCHOR_KEY（Anchor API 密钥）即可启用此功能；PRIVI_ANCHOR_INTERVAL 可更改间隔（秒，默认值为 300）。

支付方式（通过 MCP 使用 x402）

遵循 x402 v2 MCP transport spec：

1. Agent 调用付费工具。服务返回 isError: true 和一个 PaymentRequired 对象，其中列出价格、网络、USDC 合约和 payTo 钱包。
2. Agent 的钱包对 USDC 授权进行签名，并将签名放入 _meta["x402/payment"] 后重试。
3. 服务检查付款是否符合价格要求，让 facilitator 验证付款，运行工具，再让 facilitator 结算付款，并在 _meta["x402/payment-response"] 中附上收据后返回结果。

如果结算失败，Agent 将无法获得结果。款项会直接转入 PRIVI_PAY_TO 钱包；服务不会持有资金或私钥。

运行

pip install .
cp .env.example .env        # set PRIVI_PAY_TO and PRIVI_WRITE_KEYS
python scripts/seed_demo.py # optional demo lots (or set PRIVI_SEED_DEMO=1)
privi-verify-mcp            # HTTP on :8000, MCP endpoint at /mcp

通过 stdio 运行（例如 Claude Desktop）：

{
  "mcpServers": {
    "privi-verify": {
      "command": "privi-verify-mcp",
      "args": ["--stdio"],
      "env": { "PRIVI_PAY_TO": "0xYourWallet", "PRIVI_NETWORK": "base-sepolia" }
    }
  }
}

远程客户端连接到 https://<your-host>/mcp。GET /health 会返回状态。

进行测试付款

scripts/test_payment.py 使用一次性 Base Sepolia 钱包，按照 AI Agent 的实际付款方式向在线服务付款（免费测试网 USDC，无需真实资金）：

pip install eth-account
python scripts/test_payment.py --new-wallet   # prints a test wallet address
# get testnet USDC at https://faucet.circle.com (Base Sepolia), then:
python scripts/test_payment.py                 # pays $0.01, verifies DEMO-STEEL-0001, prints the tx link

密钥会保存到 .agent-wallet（已加入 Git 忽略列表）。除非传入 --allow-mainnet，否则脚本不会在主网上付款。

部署

Dockerfile 可在 Railway、Render、Fly 或任何容器主机上运行：

• 设置 PRIVI_PAY_TO、PRIVI_WRITE_KEYS 和 PRIVI_NETWORK。
• 在 /data 挂载卷，以便 SQLite 数据库在重新部署后保留。
• 使用测试网 USDC，在 base-sepolia 上启动。只有在完整测试付款成功后才切换到 base，并将 PRIVI_FACILITATOR_URL 设置为生产环境的 facilitator，因为公共 facilitator 仅支持测试网。

记录事件

curl https://<your-host>/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer <your-write-key>' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"privi_record_event",
       "arguments":{"lot_code":"LOT-0001","event_type":"produced","location":"Port Huron, MI",
                    "actor":"Your Plant","product":"Bracket A-12","quantity":"800 pcs"}}}'

开发

pip install -e ".[dev]"
pytest

测试涵盖支付流程（缺失、金额不匹配、无效和结算失败的支付）、篡改检测和写入授权，并使用替代用的支付协调器。

路线图

• 按制造商划分的账户和仪表板（Privi ChainFlow）
• 用于多实例托管的 Postgres 存储
• 在 MCP 目录中列出

许可证

MIT © 2026 Dario Canoy, Privi World Co