agent-receipts-mcp

agent-receipts

证明你的 AI Agent 做了什么。

2026 年 8 月 2 日，欧盟《人工智能法案》针对高风险 AI 系统的记录保存义务开始生效：自动记录事件（第 12 条）、部署者至少保存日志六个月（第 26 条），以及最高 1,500 万欧元或全球营业额 3% 的罚款。审计员、监管机构或交易对方会问你的问题很简单：

“你的 AI Agent 批准了这件事。证明它具体做了什么——并证明没有人修改过记录。”

普通日志文件无法回答这个问题：拥有日志的人可以修改它。agent-receipts 会为每项重要的 Agent 操作生成带有加密签名和时间戳的回执，任何人都可以离线验证——并导出签名审计包，供你直接交给合规负责人。

回执能证明什么

• 发生了什么、何时发生——操作类型、摘要、执行者、主体、ISO 8601 时间戳
• 记录未被篡改——对规范 JSON 进行 Ed25519 签名；只要改动一个字符，验证就会失败
• 没有内容被删除——回执按每个保险库的单调递增序列号进行哈希链式关联；每次审计导出都会自动标记缺口（删除）和链中断
• 不暴露你的数据——采用仅哈希的隐私保护方式：对负载进行 SHA-256 指纹处理后立即丢弃，不会存储或传输

为审计对话而打造

export_audit_bundle 会生成合规工作实际需要的内容：指定日期范围内的所有回执、防篡改报告（序列号缺口、链中断）、签名公钥，以及对整个审计包的清单签名。保留期限由你控制——保险库是一个本地 SQLite 文件，你可以按第 26 条（或你的政策）要求的期限自行保存。

你不必信任我们。你可以使用随附的 CLI，根据固定的公钥离线验证回执——无需账户、无需网络调用，也不依赖这项服务明天是否仍然存在。这正是证据能够持久可靠的原因。

快速开始（MCP — 本地、免费）

// Claude Desktop / Claude Code / any MCP client
{
  "mcpServers": {
    "agent-receipts": {
      "command": "npx",
      "args": ["-y", "agent-receipts-mcp"],
      "env": { "AGENT_RECEIPTS_DATA": "<where-to-keep-the-vault>" }
    }
  }
}

需要 Node.js >= 22.13（使用内置的 node:sqlite——没有原生依赖）。 想要一键安装？从 Releases 获取 .mcpb 安装包，并用 Claude Desktop 打开。

工具	Agent 应在何时调用
issue_receipt	每次重要操作完成后立即调用。返回签名回执。
verify_receipt	在信任其他 Agent 或系统提供的回执之前调用。
export_audit_bundle	人员要求提供某个日期范围的审计轨迹时调用。
get_service_info	获取用于离线验证的公钥并固定它。

快速开始（HTTP API）

npm install && npm run build
npm run serve        # http://localhost:8787

# 1. Create a vault (returns your API key — shown once)
curl -X POST localhost:8787/v1/vaults -d '{"name":"acme-compliance"}'

# 2. Issue a receipt after an agent action
curl -X POST localhost:8787/v1/receipts \
  -H "Authorization: Bearer ark_..." \
  -d '{"action_type":"invoice.approved","summary":"Approved INV-1042 for EUR 1,250",
       "payload":{"invoice":"INV-1042","amount":1250},"actor":"agent:ap-bot@acme"}'

# 3. Anyone can verify — no auth
curl -X POST localhost:8787/v1/verify -d '{"receipt":{...}}'

# 4. Export a signed audit bundle for the compliance officer
curl "localhost:8787/v1/export?from=2026-01-01" -H "Authorization: Bearer ark_..."

供机器发现的服务清单：GET /.well-known/agent-receipts.json。

离线验证

npx -y -p agent-receipts-mcp agent-receipts-verify receipt.json --pubkey <base64-spki-der>
# exit 0 = authentic, exit 1 = invalid/tampered

回执格式（agent-receipts/v1）

{
  "schema": "agent-receipts/v1",
  "id": "rcpt_...",
  "vault_id": "vlt_...",
  "sequence": 42,                      // monotonic per vault; gaps = deletion evidence
  "issued_at": "2026-07-15T12:34:56.789Z",
  "action": {
    "type": "invoice.approved",
    "summary": "Approved invoice INV-1042 for EUR 1,250",
    "actor": "agent:ap-bot@acme",      // optional
    "principal": "acme-gmbh",          // optional
    "context": { "jurisdiction": "EU" } // optional
  },
  "payload_hash": "sha256:...",        // or null; contents never stored
  "prev_receipt_hash": "sha256:...",   // hash chain to the previous receipt
  "key_id": "key_...",
  "public_key": "<base64 SPKI DER>",   // embedded for offline verification
  "signature": "<base64 Ed25519 over canonical JSON of everything above>"
}

规范化方式遵循 JCS 风格：按字典序排列键，不含空白字符。 JSON Schema 位于 docs/receipt.schema.json。

欧盟《人工智能法案》映射（仅供参考）

义务	agent-receipts 的帮助方式
第 12 条 — 自动记录事件	每次重要操作都调用 issue_receipt；记录时间戳、执行者，并形成可追溯的链
第 26 条 — 日志保存期限 ≥ 6 个月	本地保险库由你按自己的要求保存；签名的 export_audit_bundle 可用于移交
可追溯性 / 完整性	Ed25519 签名、哈希链、删除检测、离线验证

**非法律建议。**你的系统是否属于“高风险”，以及必须记录哪些内容，应咨询你的法律顾问。agent-receipts 提供的是证据基础设施。

状态与路线图

• 核心功能：使用哈希链和 Ed25519 签发 / 验证 / 导出
• MCP stdio 服务 + HTTP API + 离线验证器 CLI + MCPB 捆绑包
• 按每份收据定价的托管保险库
• RFC 3161 / 透明日志时间戳锚定
• 密钥轮换和多密钥验证

MIT 许可证。