seal
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
seal
给 AI 干的活盖章。一个命令生成可验收的交付凭证,下一个 AI 一读就接手。
License: MIT · Node ≥ 18 · Deps: 0 · Tests: 174/174(徽标位先放文字,仓库开通后再换成图)
为什么是「接手」排第一
理清一下这工具到底在替谁解决什么:
层 | 真实需求 | 使用频率 | 现在的做法 |
接手 | 换个会话、换个人、换个 agent,接着上一棒干 | 每天,每次换上下文 | 把聊天记录粘过来,或者从头问一遍 |
凭证 | 交付时不用靠「你信我」 | 一周一次 | 截图 + 一句「做完了」 |
防篡改 | 出事后能证明「这版没被改过」 | 一年一次,出事那天才用 | 说不清 |
所以 seal 的主入口是 resume(接管简报),不是凭证页。凭证是它的副产物:因为要能接手,才必须先把「上一棒干了什么」写成一份可核验的东西。
三条痛点,对应三个功能:
老板问「做完了吗」,你只能回一句「做完了」,然后他选择信你。
换个会话,下一个 AI 完全不知道上一轮改过哪几个文件、跑过什么测试,得从头问一遍。
交付物发过去,三天后数字被人动过,谁也说不清是谁改的、什么时候改的。
Related MCP server: ArtifactGuard
它做什么
命令 | 干什么 | 你会看到 |
| 主入口:把凭证翻成接管简报——这是什么活 / 改了哪些文件 / 验过什么 / 下一步 / 接手提示 | 一屏七段,最后一行告诉你该跑什么 |
| 同一份简报的机器可读版( | 一段 JSON |
| 盖章:扫当前项目近 30 分钟改过的文件,连同命令记录算成一份凭证 |
|
| 跑一条命令并把完整输出记进 | 命令自己的输出 + |
| 验真:重算链哈希、逐个文件哈希;凭证里标了 |
|
| 连同 |
|
| 以 MCP server 方式跑:让 agent 自己盖章、自己接手,不用你敲命令 | 见下方「在 MCP 客户端里用」 |
| 生成 ed25519 密钥( | 指纹 + 公钥路径 |
| 把对方/对方的公钥加进 |
|
| 把 |
|
| 用默认浏览器打开 | 一页 A4 凭证 |
| 打印用法 | 上面几行 |
盖章时可选:--summary "一句话结论"、--status done|partial|blocked、--todo "下一步"(写进凭证的 next)、--prev 上一份凭证的哈希(串成链)、--window 分钟(默认 30)。
resume 找凭证的顺序:--receipt <路径> → 从当前目录向上找 seal-out/receipt.json → ~/.seal/last-receipt(上次盖章记下的指针)。三条都不通,退出码 3,提示「这个目录里没有凭证,先跑 seal 盖章」。
30 秒上手
需要 Node 18+,不用装任何依赖。下面整段可以直接粘进 cmd 跑,只需改前两行:
:: 只改这两行:SEAL = 你机器上 bin\seal.js 的路径;cd 的目标 = 要交付的项目
set SEAL=D:\aa\seal\bin\seal.js
cd /d D:\work\my-project
:: 1. 跑一条命令,把完整输出记进 commands.jsonl(这一步可选)
node %SEAL% run -- npm test
:: 2. 盖章(扫近 30 分钟改过的文件 + commands.jsonl 里的命令记录)
node %SEAL%
:: 3. 换个会话、换了个人,先用这条接上
node %SEAL% resume
:: 4. 验真(通过退出码 0,不通过退出码 1)
node %SEAL% verify真跑出来是这样(docs/shots/01-seal.png):

在 MCP 客户端里用
MCP server 是零依赖的单个文件,用 node 直接拉起来就行。配置片段(Claude Desktop / 任何支持 stdio MCP 的客户端,路径改成你机器上的):
{
"mcpServers": {
"seal": {
"command": "node",
"args": ["<插件目录>\\bin\\seal-mcp.js"]
}
}
}它给 agent 四个工具:
工具 | 参数 | 返回 |
|
|
|
|
|
|
|
| 简报文本 + 结构化字段(同 |
|
| 凭证摘要(不含 HTML 正文) |
一次真实的调用与返回(tools/call → seal_resume):
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"seal_resume","arguments":{"cwd":"D:\\work\\my-project"}}}{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [{ "type": "text", "text": "接管简报 · SEAL-20261115-213807 · 2026-11-15T21:38:07+08:00 · 部分验证\n====================================================================\n这是什么活\n 这次交付改动 1 个文件、留下 1 条命令记录,可以验收。\n\n改了哪些文件(1 个)\n a.txt (2 B) 73cb3858\n\n验过什么:1 条命令,1 条通过,0 条失败\n\n下一步:未声明\n接手提示:有 1 条命令没重跑,先 verify --allow-run 再接手\n机器可读:加 --json 输出" }],
"structuredContent": {
"id": "SEAL-20261115-213807",
"createdAt": "2026-11-15T21:38:07+08:00",
"status": "done",
"summary": "这次交付改动 1 个文件、留下 1 条命令记录,可以验收。",
"files": [{ "path": "a.txt", "bytes": 2, "sha256": "73cb3858a687a849…" }],
"commands": [{ "cmd": "node -v", "exit": 0, "ms": 5, "ok": true, "recheck": true }],
"next": null,
"verify": { "state": "partial", "label": "部分验证", "filesChanged": 0, "commandsSkipped": 1, "signature": "none" }
}
}
}协议细节,写清楚免得猜:
传输是 stdio,每行一个 JSON-RPC 2.0 消息(newline-delimited,不带
Content-Length头)。实现了
initialize/notifications/*(不回包)/ping/tools/list/tools/call。未知方法 →
-32601;参数不对(缺 name、未知工具、类型错、不认识的参数)→-32602;坏 JSON 行 →-32700且不影响后续消息。stdout 只有协议消息,日志一律走 stderr——混一行就会把整条流打坏。
seal_verify在 MCP 里永远不带--allow-run:不给 agent 一个「顺手执行凭证里代码」的入口。
凭证里有什么
改了什么——每个文件的路径、字节数、SHA-256(流式算的,文件多大都不读进内存)。
跑过什么——命令、退出码、耗时、输出的哈希,外加输出前 200 字留档。
结论——一句话 summary,加
done/partial/blocked三档状态,再加一条next(下一步)。链哈希——整份凭证的 SHA-256;传
--prev时和上一份凭证的哈希串起来,改中间任意一份,后面全对不上。能重跑验收——
commands.jsonl里标了"recheck": true的命令(seal run --recheck -- <命令>会自动标),verify --allow-run会真跑一遍,比对退出码和输出哈希,不是只看记录。默认不执行:凭证是别人发来的输入,不能一验就跑代码。
凭证同时给两份:receipt.json(可验)和 receipt.html(A4 一页,可直接打印或发人)。
入库建议:
receipt.json建议入库;commands.jsonl不建议入库(可能含输出片段)。

采集范围说清楚:只登记近 30 分钟内改动过的文件(
--window可调),跳过node_modules、.git、seal-out。它记的是「这次交付动了什么」,不是「仓库里有什么」。窗口外但 24 小时内改过的文件不会被静默丢掉——盖章时会打一行「注意:另有 N 个文件超出 30 分钟窗口未收录」,同时写进凭证的warnings。什么都没采到时直接拒绝出凭证(退出码 2)。
让「防篡改」成立:签名 + 时间锚
这是第三层需求,多数人一年用不上一次,但它必须是真的,否则上面两层也跟着不可信。
chain.hash 是无密钥的 sha256——算法公开,谁都能把整份凭证重写一遍再重算哈希。所以要挡住这一手,必须有一方不是你自己:
node %SEAL% keygen :: 1. 生成 ed25519 密钥(~/.seal/key.json)
node %SEAL% :: 2. 盖章,凭证里自动带 sig
node %SEAL% trust D:\某个\pubkey.json :: 3. 对方把公钥加进信任列表(对方机器上跑)
node %SEAL% verify :: 4. 对方验,才知道「谁签的、签完有没有被改」
node %SEAL% anchor :: 5.(可选)把 chain.hash 锚进一条 git 提交签名口径(固定,别改):签名对象是 chain.hash 的 UTF-8 字节;算法 ed25519;公钥指纹 = sha256(公钥 DER/SPKI) 前 16 位。凭证里的字段是 sig: { alg, pub_fpr, value(base64) }。
verify 会给三档互不混淆的结论:
情况 | 输出 |
没有 |
|
有 |
|
有 |
|
有 |
|
anchor 只写 seal-out/ANCHOR(一行 <编号> <chain.hash>)并提交这一条路径,提交信息 seal anchor <编号> <hash 前 12 位>。它不会 push——推送之后,这个时间点才真正落到别人手里,无法再改。
签名能证明的是「这份凭证是你签的、签完之后没被改」,不能证明「你写的内容是真的」。未
trust之前,「有签名」不等于「可信」。
它跟别的不一样在哪
日志 ≠ 凭证。 日志是给自己看的流水,一行一条,谁都能写;凭证是给对方看的结论加可验指纹,改一个字就验不过。
截图 ≠ 可验。 截图能 P、能截一半。
verify是当场重算哈希,不是读你写的说明。聊天记录 ≠ 能接手。 接手的人不想翻 200 条消息,他想要「改了 11 个文件、7 条命令、下一步是什么」这样一页。
改一个字节之后就是这样(docs/shots/03-verify-fail.png):

它不管什么
不做云端。 没有账号、没有上传、不联网。凭证就是你项目里那两个文件,删了就没了。
不替代测试。 它只记录你跑过什么、跑出什么,不判断这些测试够不够。
不保证代码对。 哈希证明「没变过」,不证明「写得对」。
不防一开始就撒谎。 盖章那一刻你写什么就是什么;它防的是盖章之后被改,不是盖章之前吹牛。
不管签名者自己说谎。 签名只说明「这份凭证确实是他签的」,不说明他签的内容是真的。要防这一层,得靠日志之外的证据(代码 review、测试覆盖率、别人复核),那不在 seal 的范围内。
English
What it is. Seal the work your agent did — one command produces a verifiable delivery receipt, and the next agent reads it and picks up. Zero dependencies, one file, works offline on Node 18+.
Why handoff first. The real need is not "prove I didn't cheat" — it's "don't make me re-explain what happened". A new session has no memory of which files changed, which tests ran, or what was left undone. resume turns the receipt into a handover brief: what this job was, what changed, what was verified, what's next, and one executable line telling you whether to trust the previous run.
What it does. seal hashes every file changed in the last 30 minutes (--window to widen) plus the command log in seal-out/commands.jsonl, then writes receipt.json and a one-page receipt.html. resume prints the handover brief (--json for machines). seal run -- <cmd> executes a command, streams its output and records it. verify recomputes the chain hash and re-hashes every file; commands marked "recheck": true are listed but not executed — --allow-run actually re-runs them and compares exit code and output hash.
MCP. node bin/seal-mcp.js is a zero-dependency stdio MCP server (newline-delimited JSON-RPC 2.0) exposing seal_stamp, seal_verify, seal_resume, seal_show, so an agent can stamp and resume by itself. seal_verify over MCP never executes commands from a receipt.
What's inside. Changed files with path, size and SHA-256; commands with exit code, duration and output fingerprint; a one-line conclusion with done / partial / blocked plus a next field; a chain hash linking this receipt to the previous one.
Why not just logs or screenshots. Logs are private notes, screenshots can be edited, and chat history is not a handover. A receipt is a conclusion plus fingerprints that anyone can re-check in one command — and it fails loudly the moment one byte changes.
What it does not do. No cloud, no account, no upload. It does not replace your tests, does not prove the code is correct, cannot stop you from overstating things at the moment you sign, and cannot make a signer honest.
Roadmap
GitHub Action——PR 上自动贴一份凭证,reviewer 先看凭证再看 diff。
团队版——同一项目多份凭证串一条链,谁盖的、什么时候盖的,一眼看到。
seal diff——和上一份凭证比,这次比上次变了什么。
以上三项都还没做,写完一版才会从这行挪走。(MCP server 已在 0.4.0 完成。)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hand off AI work with a signed Verification Receipt — an independent verifier proves it runs.
Shared task queue for humans and AI agents: leases, handoffs, approvals and signed receipts.
Issue signed receipts for AI agent actions; verify any receipt offline - free, no account.
AI-agent trust infrastructure for discovery, authority, execution, verification, and receipts.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to create cryptographically verifiable receipts of their delegated work, with capabilities for multi-party approval and offline verification.1184 npmApache 2.0
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to validate deliverables (JSON, ZIP, PDF, DOCX) against signed contracts, generating verifiable receipts with Ed25519 signatures.-
- AlicenseAqualityCmaintenanceEnables AI agents to send and receive structured, cryptographically-verifiable messages, with tools for inbox management, task delegation, and agent discovery.12128 npmMIT
- AlicenseBqualityCmaintenanceEnables AI agents to create, validate, verify, and merge tamper-evident task handoff records with SHA-256 receipts, so they can pass work without redoing everything and distinguish verified claims from unconfirmed ones.3MIT