Touchstone

touchstone-mcp

适用于 Touchstone 的本地 MCP 服务——将 Agent 的操作记录到具备防篡改能力并由外部锚定的日志中。

该服务在你的设备上运行，并保存你的 Ed25519 签名密钥。它在本地为每个事件签名，并将其追加到你的记录器中，因此 Agent 只需调用 touchstone_record({ event_type, payload })。密钥绝不会离开此进程。 规范化（JCS / RFC 8785）也在本地完成，因此恶意或遭入侵的服务端无法诱使你签署与你原意不同的承诺。

零依赖——仅使用 Node 18+ 内置模块。它只有一个文件：请先阅读，再决定是否信任它。

远程 MCP https://touchstone.cv/mcp 无法代你签名（Touchstone 从不持有你的密钥），因此其 touchstone_record 需要你自行计算签名。需要轻松完成本地签名时，请运行此服务。

安装

# one-off, no install:
npx -y @touchstone-cv/mcp

# or vendor the single file:
curl -O https://touchstone.cv/touchstone-mcp.mjs

# or clone:
git clone https://github.com/Touchstone-CV/touchstone-mcp && cd touchstone-mcp

配置

通过 stdio 将 MCP 客户端指向此服务：

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": ["-y", "@touchstone-cv/mcp"],
      "env": {
        "TOUCHSTONE_RECORDER": "rec_...",
        "TOUCHSTONE_SUBJECT": "<your-colony-sub>",
        "TOUCHSTONE_API_KEY": "tsk_...",
        "TOUCHSTONE_SIGNING_KEY": "<base64 Ed25519 32-byte seed>"
      }
    }
  }
}

环境变量	必需	含义
TOUCHSTONE_RECORDER	是	你的记录器公开 ID（rec_…）
TOUCHSTONE_SUBJECT	记录时需要	你的 Colony sub——记录器的主体
TOUCHSTONE_API_KEY	是	在记录器上生成的 API 密钥（tsk_…）
TOUCHSTONE_SIGNING_KEY	记录时需要	base64 编码的 Ed25519 32 字节种子——由你保管，绝不发送
TOUCHSTONE_KEY_FILE	可选	JSON 文件 {"seed_b64":"…"} 的路径，用于替代内联种子
TOUCHSTONE_BASE_URL	否	默认为 https://touchstone.cv

如需获取记录器和密钥，请参阅 touchstone.cv/developers——Agent 可使用自己的 Colony 令牌（OAuth Token Exchange，RFC 8693）自行创建，无需浏览器。

工具

工具	功能
touchstone_record	对 payload 进行 JCS 规范化，在本地签署承诺，并追加条目
touchstone_disclose	创建可分享的 /d/<token> 披露链接（代理至服务端）
touchstone_verify	验证披露包（代理至服务端）
touchstone_recorder_info	获取你的记录器公开信息／检查点状态

只有 touchstone_record 会使用你的签名密钥；其余工具会通过你的 API 密钥代理至远程服务。

选择性字段披露

调用 touchstone_record({ event_type, payload, selective_disclosure: true })，将 payload 中的每个字段分别提交——客户端在本地计算加盐字段的 Merkle 根，并将其作为 payload_hash 签名，同时存储各字段的盐。之后，你可以只披露部分字段：

touchstone_disclose({ seqs: [n], reveal: { n: ["field_a", "field_b"] } })

披露的字段会附带针对 payload_hash 的 Merkle 证明（你的签名已覆盖该值）；未披露字段会与盐绑定，其值不会出现在披露内容中。根值的计算与服务端及验证器逐字节一致。

验证日志

任何人都可以验证披露内容，无需信任 Touchstone——可以使用浏览器验证器、独立的 verify.php，或 gossip_check.py 分视图检查器。这些工具由网站提供（且每个都只有一个可审计文件）；此仓库仅包含记录客户端。

许可证

Apache-2.0。