⚓️ Truth Anchor Agent

Truth Anchor Agent 是一个用于引用证明 (citation attestation) 的 MCP (Model Context Protocol) 服务器。在代理引用来源之前，它可以验证 URL 是否可解析、记录最终目标地址、捕获轻量级页面元数据，并返回所获取内容的哈希值。

问题： AI 代理经常引用失效、重定向或已更改的 URL，而没有检查来源在引用时的状态。 解决方案： 一个付费验证步骤，在代理依赖引用之前记录来源的可用性和轻量级证明元数据。

它保证了什么

• URL 在验证时已被获取。

• 服务报告最终 URL、HTTP 状态、重定向行为和基本的 HTML 元数据。

• 响应包含 content_sha256 哈希值，以便下游系统锚定所观察到的内容。

• 可选的声明匹配是一个简单的子字符串检查。

Related MCP server: Predicate

它不保证什么

• 它不是一个语义事实核查引擎。

• 它不证明页面是可信的，仅证明服务在获取时观察到的内容。

• 它不取代搜索、RAG 或针对复杂声明的人工审查。

🛠 Model Context Protocol (MCP) 集成

该服务器公开了一个 verify_url 工具，任何兼容 MCP 的 LLM（Claude Desktop、ChatGPT、IDE）都可以自主使用。

在 Claude Desktop 中注册

将其添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "truth-anchor": {
      "command": "npx",
      "args": ["-y", "truth-anchor-agent"],
      "env": {
        "MY_WALLET_ADDRESS": "0x367B9193D4F9cb4877Ca58E6F3ce944d761d8009"
      }
    }
  }
}

接口

MCP 工具

MCP 工具使用两步流程：

1. 使用 URL 调用 verify_url。

2. 如果未提供付款证明，则接收付款说明。

3. 发送付款后使用 tx_hash 重试。

HTTP API

HTTP API 使用 API 密钥加上 x402 风格的签名支付：

1. POST /auth/provision 获取免费 API 密钥。

2. 前 50 次请求免费。

3. 之后，在 POST /verify 中附加 X-Payment。

💳 付款流程

HTTP API 为免费额度用尽后的付费请求实现了 402 Payment Required 流程。

1. 请求： 代理使用 URL 调用 /verify。

2. 质询： 服务器返回 402 Payment Required 以及付款说明。

3. 付款： 代理签署 Base USDC 付款授权。

4. 验证： 代理使用 X-Payment 标头重试。

5. 证明： 服务器验证付款并返回来源检查结果。

⚡️ API 参考

POST /verify

验证来源是否可解析并返回证明元数据。需要：

• Authorization: Bearer <api_key>

• 免费额度用尽后需要 X-Payment

标头：

请求体：

{
  "url": "https://base.org",
  "claim": "Base is an Ethereum L2"
}

成功响应 (200 OK)：

{
  "url": "https://base.org",
  "final_url": "https://base.org/",
  "is_live": true,
  "status_code": 200,
  "redirected": false,
  "ssl_valid": true,
  "checked_at": "2026-04-02T12:00:00Z",
  "content_type": "text/html",
  "content_length_bytes": 31245,
  "title": "Base",
  "description": "Base is a secure, low-cost, builder-friendly Ethereum L2.",
  "content_sha256": "9d72c4...",
  "claim": "Base is an Ethereum L2",
  "claim_found": true,
  "claim_match_method": "substring",
  "paid": false,
  "free_requests_remaining": 49
}

🏗 技术栈

• FastAPI — 高性能 Python API 框架。

• Web3.py — 实时链上验证 (Base RPC)。

• SQLite — 重放攻击预防和交易索引。

• Fly.io — 全球边缘部署。

• Base — 用于快速、低成本 USDC 支付的 L2 以太坊。

定位说明

• 主要切入点：代理的引用证明

• 目前拒绝：广泛的 真理层、通用事实核查和多工具扩展

• 产品差距和验证说明位于 docs/product-positioning.md、docs/user-validation.md 和 docs/user-validation-proxy.md

🛠 本地开发

# 1. Clone and Install
git clone https://github.com/cristiano-c1/truth-anchor-agent
cd truth-anchor-agent
pip install -r requirements.txt

# 2. Configure
echo "MY_WALLET_ADDRESS=0x367B9193D4F9cb4877Ca58E6F3ce944d761d8009" > .env

# 3. Run
uvicorn main:app --reload

📜 许可证

根据 MIT 许可证分发。有关更多信息，请参阅 LICENSE。