witnessd

Name: witnessd
Author: witnessd.vip

本地服务

github.com/jschunter安全03 天前更新

代码仓库

关于 witnessd

witnessd 是用于验证网页或 API 响应的 MCP 服务，可独立抓取公开内容、生成哈希和时间戳并归档，再签发可验证的证书。适合需要留存交易条款或第三方数据证据的 Agent。

主要功能

01独立抓取公开 URL 或 API
02生成哈希与时间戳
03归档响应并签发证书
04验证签名与 Merkle 证明
05按快照 ID 获取归档内容

适用场景

01交易前留存对方公布的价格或条款
02记录采取行动前 API 返回的数据
03为争议保存网页特定时刻的内容

MCP 相关

MCP 服务向 Agent 提供见证 URL、获取证书和检索快照的工具。证书包含签名和 Merkle 证明，可独立验证；见证与快照检索工具按次收费。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vip-witnessd-witnessd": {
      "command": "npx",
      "args": [
        "-y",
        "witnessd-mcp"
      ],
      "env": {
        "WITNESSD_URL": "<WITNESSD_URL>",
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "WITNESSD_API_KEY": "<WITNESSD_API_KEY>"
      }
    }
  }
}

启动命令npx -y witnessd-mcp

需要配置的环境变量

WITNESSD_URLBase URL of the witnessd service (default https://witnessd.vip)

EVM_PRIVATE_KEY密钥Wallet key used to auto-pay x402 invoices in USDC on Base (either this or WITNESSD_API_KEY)

WITNESSD_API_KEY密钥Prepaid witnessd credit key (alternative to EVM_PRIVATE_KEY)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmwitnessd-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
url	string	是	要进行见证的 http(s) URL 或 API 端点

详细介绍

witnessd-mcp

面向 witnessd 的 MCP 服务——为机器可读网络提供中立的第三方见证。

让你的 Agent 能够创建防篡改证据：witnessd 会独立抓取任意公开 URL 或 API 端点，对响应进行哈希处理并加上时间戳、存档，然后签发证书。快照哈希每小时通过 Merkle 树批量处理，并锚定到 Base 上，因此任何人都能永久验证证书，无需信任运营方。

在与交易对手交易前（“见证其公布的价格／条款”）、依据第三方数据采取行动前（“见证 API 返回的内容”），或任何日后可能需要围绕“某个 URL 在某个时间点显示了什么”解决争议的场景中使用它。

快速安装

你使用的工具	运行此命令
Claude Code（一步安装技能和 MCP 服务）	`/plugin install witnessd --marketplace jschunter/witnessd-mcp`
任何支持 Agent Skills 的 Agent（Cursor、Codex、Copilot、Gemini CLI 等）	`npx skills add jschunter/witnessd-mcp`
任何 MCP 客户端，仅安装 MCP 服务	`npx -y witnessd-mcp`（配置见下文）

技能（plugin/skills/witnessd/SKILL.md）会教 Agent 何时值得花两分钱请中立的第三方见证：向陌生卖家付款前、依据第三方数据采取行动前，或有人要求证明某个网页显示过什么时。它还设定了支出规则：每项任务最多付费调用 5 次，未经批准不得超出；每次调用都要用一行文字报告；不得循环付费重试。MCP 服务则为 Agent 提供工具。

在较旧版本的 Claude Code 中，运行 /plugin marketplace add jschunter/witnessd-mcp，然后运行 /plugin install witnessd@witnessd。

工具

工具	价格	功能
`witness_url`	$0.02	立即独立抓取 URL、计算哈希、添加时间戳并存档；返回快照 ID 和签名证书
`get_certificate`	免费	获取任意快照 ID 对应的证书：清单、Ed25519 签名、Merkle 证明和 Base 锚定交易
`retrieve_snapshot`	$0.05	返回存档的响应正文和证书——适用于任意快照 ID 和任意付款方（第三方可借此获取证据）

安装

npx -y witnessd-mcp

Claude Desktop / Cursor 配置：

{
  "mcpServers": {
    "witnessd": {
      "command": "npx",
      "args": ["-y", "witnessd-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x…"
      }
    }
  }
}

付款方式——两种选择

设置以下环境变量中的一个：

EVM_PRIVATE_KEY — 持有 Base 上 USDC 的钱包私钥。服务会通过 x402 自动支付每次调用费用（买家只需签名，无需 ETH 支付 Gas）。请使用专用小额钱包，切勿使用主钱包。
WITNESSD_API_KEY — 预付费额度密钥（通过 POST https://witnessd.vip/api/credits 使用 x402 付款购买 $1 套餐）。

可选：设置 WITNESSD_URL 指向其他 witnessd 实例（默认为 https://witnessd.vip）。

无需信任我们即可验证

证书可自行验证：leaf_hash = sha256(canonical-json(manifest))，由 Ed25519 签名，通过 Merkle 证明纳入每小时生成并锚定到 Base 的批次根（calldata 0x + wtns1 + root）。独立验证工具：witnessd.vip/verify.js。