KeyHalve - verify sealed documents

Name: KeyHalve - verify sealed documents
Author: keyhalve.com

远程服务

github.com/keyhalve安全012 周前更新

代码仓库

关于 KeyHalve - verify sealed documents

KeyHalve verify-MCP 是面向多个支持平台的公开只读服务，用于验证 KeyHalve 密封文档。它检查状态、完整性、证明和时间锁，不接收解密密钥；密封内容仍由持有者在浏览器中读取。

主要功能

01检查有效或已撤销状态
02验证密文完整性
03验证 rail 证明
04评估时间锁有效性
05验证失败时拒绝通过

适用场景

01检查密封文档是否已撤销
02将密文与签发承诺比对
03确认文档的 rail 证明
04检查文档是否处于有效时间窗

MCP 相关

通过无状态 Streamable HTTP 提供 `keyhalve_verify`、`keyhalve_status` 和 `keyhalve_explain` 工具。所有工具均为只读且无需身份验证。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.keyhalve.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-keyhalve-verify https://mcp.keyhalve.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-keyhalve-verify":{"type":"http","url":"https://mcp.keyhalve.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-keyhalve-verify":{"type":"http","url":"https://mcp.keyhalve.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-keyhalve-verify":{"type":"http","url":"https://mcp.keyhalve.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-keyhalve-verify":{"serverUrl":"https://mcp.keyhalve.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@keyhalve/verify-mcp0.1.0stdio

工具

参数	类型	必填	说明
input	string	是	KeyHalve 验证 URL、QR 码文本或纯文档 id。

详细介绍

KeyHalve verify-MCP

免费、公开、无需账号的 MCP 服务，可让任何 AI 验证由 KeyHalve 封存的文档——适用于该网络中的任何平台（ValidPay、CheckBooks 等）。 Seal = 大门（平台的付费 MCP）。Verify = 房间（此服务，永久免费）。

端点： https://mcp.keyhalve.com/mcp（Streamable HTTP，无状态）
工具： keyhalve_verify · keyhalve_status · keyhalve_explain — 全部为只读工具，无需身份验证

盲区规则

此服务永远不会接收解密密钥。验证 URL 会在 #key= 片段中携带持有者的密钥份额；parseInput 会在运行任何其他逻辑之前丢弃所有片段，并在响应中说明这一点。此处的验证涵盖所有无需密钥即可证明的内容：

检查项	含义
status	签发平台上的状态：有效 / 已撤销（含原因）
ciphertext integrity	所提供密文的 SHA-256 = 签发时记录的承诺（v2）
rail attestation	使用固定的 rail 密钥验证 Ed25519；存在双重签名时验证内容绑定
time lock	有效期窗口由客户端判断（专利 D 语义）
issuer trust	默认拒绝：至多为 `declared`，绝非证明

读取封存内容仍然只会在持有者的浏览器中进行——与网页验证器完全相同。整体判定默认拒绝：任何检查失败 → FAILED — DO NOT TRUST。

设计说明

零运行时依赖。 仅使用 WebCrypto；整个协议层都可手动审计。原理与 keyhalve-website 中固定密钥的 rail 客户端相同。
无状态。 无会话、无 SSE、无 KV、无 Cookie；每个 POST 都会收到 application/json。永不记录请求正文。
与租户无关。 平台数据与网页验证器使用相同的清单数据（src/verifier.ts 中的 TENANT_MANIFEST）；接入平台 = 添加一条数据。
默认拒绝。 rail 无法访问、份额格式错误、双重签名绑定不完整、id 前缀未知——全部报告为未验证，绝不予以宽松通过。

开发 / 部署

npm ci
npm run typecheck && npm test   # 32 tests
npm run dev                      # wrangler dev

部署为手动执行（通过 workflow_dispatch 运行 deploy.yml，遵循与 rail/console 相同的规范）。需要仓库密钥 CLOUDFLARE_API_TOKEN；路由 mcp.keyhalve.com 是 business CF 账号上的自定义域名（与 watchdog scheduler 使用同一账号）。

目录提交（需 Mike 批准）

提交至 Claude Connectors Directory / ChatGPT App Directory 属于对外操作——需单独准备，只有 Mike 批准后才会提交。

列表资源

目录列表所需素材存放在此仓库中——请复用，不要另行编写文案：

llms-install.md — AI Agent 安装步骤（Cline 的 AI 驱动安装流程；也是各客户端规范用法的权威版本）。
glama.json — Glama 声明文件（维护者；其实时架构仅对维护者开放）。
assets/icon-400.png — 400×400 图标（品牌素材包中的白色分割圆形图案，背景为 Ink #0E1116）。
描述必须与 src/tools.ts 按字节保持一致，并符合已批准声明登记表（不得出现“split key”“tamper-proof”或声称发行方身份的内容）。