cryptair-mcp-server

Cryptair MCP 服务

面向 AI Agent 的密码学证明，通过原生 MCP 工具提供。

任何支持 MCP 的 Agent（Claude Desktop、Cursor、Cline、Windsurf、Zed，……）都可以在 Hedera Hashgraph 上生成链上回执，用于证明协议、认证文档并验证对方声明。开箱即用，无需配置：Agent 可以自行注册并立即开始使用证明功能，无需验证电子邮件，也无需人工参与注册。

功能

Cryptair 让两个 Agent（或一个 Agent 和一个人）能够证明，他们在特定时间就同一数字内容达成了一致。每项确认的协议都会以 SHA-256 哈希的形式写入 Hedera Hashgraph，生成永久且可由第三方验证的回执。

此 MCP 服务提供六种工具，与 Agent 的思维方式自然契合：

工具	调用时机
certify_document	“我想证明这个文件在这一刻存在。”
verify_document	“这个文档之前是否经过证明？有没有被篡改？”
initiate_attestation	“我想让对方确认他们持有的文档和我的相同。”
submit_attestation	“我收到了某人发来的证明链接——确认我持有匹配的文件。”
check_attestation	“这个证明会话目前是什么状态？”
register_agent	“为我创建一个 Cryptair 账户，以便我进行身份验证。”

安装

npm install -g @cryptair/mcp-server

也可以通过 npx 直接运行（无需安装）：

npx -y @cryptair/mcp-server

配置

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "cryptair": {
      "command": "npx",
      "args": ["-y", "@cryptair/mcp-server"]
    }
  }
}

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "cryptair": {
      "command": "npx",
      "args": ["-y", "@cryptair/mcp-server"]
    }
  }
}

Cline / Windsurf / Zed

所有支持 MCP 的客户端都使用相同的配置格式。将它们指向 npx -y @cryptair/mcp-server。

可选：预先配置凭据

如果你已有 Cryptair API 密钥，可以通过 env 提供，让 Agent 跳过注册：

{
  "mcpServers": {
    "cryptair": {
      "command": "npx",
      "args": ["-y", "@cryptair/mcp-server"],
      "env": {
        "CRYPTAIR_API_KEY": "ctr_live_..."
      }
    }
  }
}

否则，Agent 首次需要进行身份验证时会调用 register_agent，API 密钥会自动静默保存到 ~/.cryptair/credentials.json，供之后使用。

Agent 提示词示例

安装后，可以尝试以下提示词：

“为 ~/Documents/proposal-v3.pdf 的内容生成证明，以便我们获得带时间戳的回执。”

“将 ~/Documents/contract.pdf 发给 Acme Corp，让他们正式确认收件——生成链接。”

“Acme 发给我这个 Cryptair 链接：https://www.cryptair.io/attest/abc...?token=xyz。确认 ~/Downloads/contract.pdf 与他们发送的文件一致。”

“证明会话 abc-123 的状态是什么？”

Agent 会选择合适的工具，并自动处理凭据初始化。

证明工作原理

单方证明（certify_document）

1. MCP 服务在本地使用 SHA-256 对文件进行哈希处理。
2. 哈希值会发送到 Cryptair，由其写入 Hedera 共识服务主题。
3. 你会收到 Hedera 交易 ID、共识时间戳和公开证书 URL。
4. 任何人都可以重新计算文件的哈希并调用 verify_document 进行验证——文件内容无需离开你的设备。

双方证明（initiate_attestation + submit_attestation）

1. Agent A 使用文档哈希和对方名称发起证明。Cryptair 会返回一个可分享的 URL。
2. Agent A 通过任意渠道（电子邮件、Slack 等）将 URL 发给 Agent B。
3. Agent B 打开 URL 并提交自己持有的文件。其 MCP 服务会在本地对文件进行哈希处理。
4. Cryptair 在服务端比较哈希值：
   • 匹配 → 双方的协议都会写入 Hedera，形成永久记录。
   • 不匹配 → 篡改事件会写入 Hedera，并通知双方。

Agent B 无需拥有 Cryptair 账户即可参与。如果 Agent B 提交时提供了电子邮件地址，系统会自动为其创建账户，其 MCP 服务也会静默保存 API 密钥——这样他们之后便可自行发起证明，无需经历繁琐的注册流程。

为什么选择 MCP，而非技能

此服务在设计上支持跨供应商。Anthropic Skills 仅适用于 Claude；MCP 则适用于 Claude Desktop、Cursor、Cline、Windsurf、Zed 以及未来任何支持 MCP 的客户端。安装一次，即可用于所有 Agent 生态系统。

环境变量

变量	用途	默认值
CRYPTAIR_API_KEY	预配置的 API 密钥。跳过 register_agent。	（无）
CRYPTAIR_EMAIL	如果调用时未提供，则用于 submit_attestation 自动配置的电子邮箱。	（无）
CRYPTAIR_BASE_URL	API 基础 URL。可针对可自托管或暂存环境进行覆盖。	https://www.cryptair.io

开发

git clone https://github.com/Syronius/cryptair-mcp-server
cd mcp-server
npm install
npm run build
npm start

此服务通过标准输入/输出使用 JSON-RPC。要手动测试，请发送 tools/list，确认已注册全部六个工具。

免费套餐与定价

Cryptair 免费套餐目前允许每个账户每月发起少量证明。对手方完成证明（submit_attestation）始终免费。高频用户可以充值预付额度——详情请参阅 cryptair.io/pricing。

许可证

MIT