Orphograph

Orphograph MCP 服务

一个单文件的模型上下文协议服务，让 Claude / Claude Code / Cursor / 任意 MCP 主机实例都能通过 Orphograph 将文件锚定到比特币区块链上，而文件本身始终不会离开用户的设备。

mcp-name: io.github.Orphograph/orphograph

• 许可证： MIT
• 依赖项： 仅使用 Python ≥ 3.9 标准库。也可在 PyPI 上获取，包名为 orphograph-mcp，版本为 0.1.1。
• 代码行数： 约 310 行，单个文件。
• 协议： 通过 stdio 使用 MCP 2024-11-05。

安装

将脚本保存到任意位置：

curl -sSL https://orphograph.com/mcp/orphograph_mcp.py -o ~/bin/orphograph_mcp.py

然后将其注册到你的 MCP 主机。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）

{
  "mcpServers": {
    "orphograph": {
      "command": "python3",
      "args": ["/Users/YOU/bin/orphograph_mcp.py"],
      "env": {
        "ORPHO_API_KEY": ""
      }
    }
  }
}

Claude Code

claude mcp add orphograph python3 /Users/YOU/bin/orphograph_mcp.py

也可以编辑 ~/.claude/settings.json，添加相同的 mcpServers 配置块。

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "orphograph": {
      "command": "python3",
      "args": ["/Users/YOU/bin/orphograph_mcp.py"],
      "env": {
        "ORPHO_API_KEY": ""
      }
    }
  }
}

提供的工具

工具	用途	身份验证
orphograph_anchor_file(path)	计算本地文件的哈希，并将其指纹登记到比特币区块链上。	API 密钥可选
orphograph_anchor_folder(path)	计算整个文件夹的哈希，构建 RFC-6962 默克尔树，并锚定一个覆盖所有文件的根哈希。	API 密钥可选
orphograph_anchor_output(text, …)	在进程内计算生成内容（Agent 结果、文字记录）的哈希并进行锚定。可接受可选的 zk_proof。	API 密钥可选
orphograph_verify_receipt(receipt_id)	查询服务端记录的回执信息。仅执行查询，不会检查区块链；请运行 ots verify 进行验证。	无
orphograph_verify_lineage(receipt_id)	沿编辑谱系链回溯，检查其已提交的父项。	无
orphograph_list_vault(limit?)	列出订阅者的回执。	需要 API 密钥

隐私保障

• 文件内容不会离开设备。
• 脚本在进程内计算 SHA-256 + SHA-512，并仅将这些指纹发送到 https://orphograph.com/api/anchor。
• 只有主机明确调用工具后，脚本才会进行网络请求。
• 文件以 1 MB 为单位分块读取；大文件不会被完整加载到内存中。

配置

环境变量	用途
ORPHO_API_KEY	可选。通过 orphograph.com/account.html 获取。未设置时，此安装会受到免费套餐限制（每 24 小时 3 次锚定）。
ORPHO_BASE_URL	可选。默认值为 https://orphograph.com。可覆盖此值以用于测试或可自托管的实例。

套餐和限制

套餐	限额	价格
免费	每 24 小时 3 次锚定	$0
Writer Pack	10 次锚定，永不过期	一次性支付 $19
Pack of Fifty	50 次锚定，永不过期	一次性支付 $29
Standing Order	不限次数锚定	每月 $9

验证

MCP 服务只负责发出调用。它生成的每份回执都可以在不依赖本服务的情况下，通过以下两个独立步骤进行检查：

1. 结构 — 使用 github.com/Orphograph/Orphograph 上的开源验证器重新计算哈希，并离线检查回执。验证器自身不会发起网络请求。
2. 区块链 — OpenTimestamps 客户端（ots verify）会确认该承诺确实写入了比特币区块。传入 --ots 时，随附的验证器会为你调用它。

只有第 2 步会查询比特币区块链。

报告问题

请在公开仓库中提交问题，或发送邮件至 [email protected]。