关于 otskit-mcp
otskit-mcp 是供 Agent 使用的 OpenTimestamps 服务,可将文档哈希时间戳记录到 Bitcoin,并管理时间戳证明。它提供创建、确认状态监控和验证功能,也支持本地文件及外部证明。
主要功能
- 01创建 Bitcoin 时间戳
- 02升级待确认证明
- 03验证时间戳证明
- 04检查和列出已存时间戳
- 05计算本地文件哈希并加盖时间戳
- 06监控待升级记录
适用场景
- 01为文档哈希加盖时间戳
- 02检查证明是否已确认
- 03根据外部证明验证文件
- 04跟踪待处理时间戳及重试
MCP 相关
该服务向兼容 MCP 的 Agent 提供创建时间戳、升级、验证、检查、列出、监控和文件哈希等工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@otskit/mcp
OpenTimestamps MCP 服务 — 通过 AI Agent 为时间戳加盖、升级和验证 Bitcoin 时间戳。
向任何兼容 MCP 的 Agent 提供一组工具,让其能够为文档添加时间戳、监控确认状态,并根据 Bitcoin 区块链验证证明——全部通过对话完成。
这是 OpenTimestamps 协议的独立实现,与 OpenTimestamps 项目无关,也未获得其认可或由其维护。
关于确认时间的说明: 加盖时间戳后,在 Bitcoin 确认之前,证明会处于
pending状态。确认通常会在 ~60 分钟 内到达,但在网络拥堵时可能需要 数小时。使用ots-mcp watch或upgrade_timestamp进行监控。待处理的证明并不代表证明失败。
安装
npm install -g @otskit/mcp
Agent 设置
ots-mcp setup claude # Claude Desktop
ots-mcp setup claude-code # Claude Code CLI
ots-mcp setup codex # Codex CLI
每条命令都会将 MCP 条目写入 Agent 的配置文件;如果文件已存在,则会创建 .bak 备份;如果已配置 ots-mcp,则会跳过。之后重启 Agent 以应用更改。
CLI 命令
| 命令 | 描述 |
|---|---|
ots-mcp serve | 启动 MCP 服务(stdio 传输) |
ots-mcp stamp <sha256> | 根据 Bitcoin 日历为 SHA-256 哈希加盖时间戳 |
ots-mcp upgrade <id> | 检查待处理的时间戳是否已确认 |
ots-mcp verify <id> | 根据 Bitcoin 验证时间戳 |
ots-mcp list [status] | 列出时间戳(pending / confirmed / failed) |
ots-mcp watch [minutes] | 监控待处理的时间戳,并尝试升级已到期的时间戳(默认:30 分钟,最短:15 分钟) |
ots-mcp check-pending | 对所有待处理的时间戳执行一轮升级 |
ots-mcp scheduler install|remove|status | 管理操作系统级调度器以自动升级 |
ots-mcp backup [dest] | 备份 SQLite 数据库 |
ots-mcp setup <claude|claude-code|codex> | 为 Agent 配置 MCP |
向 Agent 提供的 MCP 工具
| 工具 | 描述 |
|---|---|
create_timestamp | 将 SHA-256 哈希提交到 4 个公共 OTS 日历 |
upgrade_timestamp | 检查待处理的时间戳是否已在 Bitcoin 中确认 |
verify_timestamp | 验证时间戳,证明哈希在指定的 Bitcoin 区块之前已存在 |
verify_external_proof | 使用外部 .ots 证明验证列入白名单的本地文件,不更改本地时间戳存储 |
inspect_timestamp | 检查已存储的证明文件,不进行网络调用 |
list_pending | 列出时间戳及其状态、重试次数和筛选条件 |
watch | 打开终端窗口,监控待处理的时间戳并尝试执行到期升级 |
hash_file | 计算本地文件的 SHA-256 哈希,并以 64 位十六进制字符串的形式返回(不进行网络调用) |
stamp_file | 计算本地文件的 SHA-256 哈希,并一步将其提交到 Bitcoin |
数据目录
所有数据都存储在 ~/.ots-mcp/ 中:
~/.ots-mcp/
ots-mcp.db # SQLite database (stamps, proof files)
config.json # Optional config overrides
ots-mcp.log # Log file
配置
创建 ~/.ots-mcp/config.json 以覆盖默认设置:
{
"stamp_enabled": true,
"scheduler_interval_minutes": 30,
"retry_max_attempts": 20,
"calendar_timeout_ms": 10000,
"calendars": [
"https://alice.btc.calendar.opentimestamps.org",
"https://bob.btc.calendar.opentimestamps.org",
"https://finney.calendar.eternitywall.com",
"https://btc.calendar.catallaxy.com"
]
}
开发
npm run build # production build
npm run dev # watch mode
npm test # run tests
依赖项
@otskit/client- OTS 日历客户端(引入@otskit/core,即协议引擎)@modelcontextprotocol/sdk- MCP SDKnode-sqlite3-wasm- 本地数据库(纯 WASM,无需原生编译)
需要 Node.js >= 20。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。