Cryptair Mcp Server

io.github.Syronius由 GitHub 账号 Syronius 发布v0.1.1更新于 Nov 10, 2026

Tamper-evident attestation tools for AI agents — on-chain receipts on Hedera Hashgraph mainnet.

已验证STDIO仅桌面金融安全与监控

概览

AI 生成的概览

该 MCP 服务器让智能体对文档进行认证,并通过 Hedera Hashgraph 上的防篡改链上凭证证明双方协议。

可以做什么
  • 在本地对文档做哈希并写入 Hedera,生成带时间戳的认证凭证
  • 将文件与既有认证记录比对,检测是否被篡改
  • 发起双方认证并生成可分享给对方的链接
  • 提交收到的认证链接,确认对方持有相同文件
  • 查询认证会话的当前状态
  • 注册 Cryptair 账户以便智能体完成身份验证
适用场景
当智能体或其用户需要证明某文档在特定时间已存在,或证明双方持有同一文件,并需要第三方可核验的凭证时适用。适合合同、方案书与文件交接等重视可验证记录的流程。
运行要求
以 stdio 方式在本地运行,通常通过 npx 启动,需要 Node.js。可通过 CRYPTAIR_API_KEY 提供已有的 Cryptair API 密钥;若不提供,智能体会自行注册并把密钥保存到本地凭据文件。另有可选的 CRYPTAIR_EMAIL 与 CRYPTAIR_BASE_URL。需要能访问 Cryptair API 的网络。
安装前请注意
未预设密钥时,智能体可自行创建账户并把 API 密钥存入本地凭据文件,无需人工注册。文档哈希、对方名称及所填邮箱会发送给 Cryptair 并写入公开账本,应视为公开信息。认证记录永久保存且无法撤销。免费额度限制每月认证次数,超出部分需付费。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Cryptair Mcp Server,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Cryptair MCP Server

Cryptographic attestation for AI agents, exposed as native MCP tools.

Lets any MCP-capable agent (Claude Desktop, Cursor, Cline, Windsurf, Zed, …) prove agreements, certify documents, and verify counterparty claims with on-chain receipts on Hedera Hashgraph. Works zero-config out of the box: agents can self-register and start using attestation immediately, with no email verification or human-in-the-loop signup.

What It Does

Cryptair lets two agents (or an agent and a human) prove they agreed on the same digital artifact at a specific moment. Every confirmed agreement is written as a SHA-256 hash to Hedera Hashgraph, producing a permanent, third-party-verifiable receipt.

This MCP server exposes six tools that map cleanly to how agents think:

ToolWhen to call
certify_document"I want to prove this file existed at this moment."
verify_document"Has this document been attested before? Is it tampered?"
initiate_attestation"I want my counterparty to confirm they have the same document I do."
submit_attestation"I received an attestation link from someone — confirm I have the matching file."
check_attestation"What's the status of this attestation session?"
register_agent"Create a Cryptair account for me so I can authenticate."

Install

bash
npm install -g @cryptair/mcp-server

Or run directly via npx (no install needed):

bash
npx -y @cryptair/mcp-server

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Edit ~/.cursor/mcp.json:

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

Cline / Windsurf / Zed

All MCP-capable clients use the same config shape. Point them at npx -y @cryptair/mcp-server.

Optional: Pre-configure Credentials

If you already have a Cryptair API key, you can supply it via env so the agent skips registration:

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

Otherwise, the agent will call register_agent the first time it needs authentication, and the API key is silently stored at ~/.cryptair/credentials.json for future use.

Example Agent Prompts

After installing, try prompts like:

"Certify the contents of ~/Documents/proposal-v3.pdf so we have a timestamped receipt."

"Send ~/Documents/contract.pdf to Acme Corp and get them to formally acknowledge receipt — generate the link."

"Acme sent me this Cryptair link: https://www.cryptair.io/attest/abc...?token=xyz. Confirm ~/Downloads/contract.pdf matches what they sent."

"What's the status of attestation session abc-123?"

The agent will pick the right tool and handle credential bootstrapping automatically.

How Attestation Works

Single-party (certify_document)

  1. The MCP server hashes the file locally with SHA-256.
  2. The hash is sent to Cryptair, which writes it to a Hedera Consensus Service topic.
  3. You get back a Hedera transaction ID, consensus timestamp, and a public certificate URL.
  4. Anyone can verify by re-hashing the file and calling verify_document — the file content never has to leave your machine.

Two-party (initiate_attestation + submit_attestation)

  1. Agent A initiates with a document hash and counterparty name. Cryptair returns a shareable URL.
  2. Agent A sends the URL to Agent B via any channel (email, Slack, etc.).
  3. Agent B opens the URL and submits the file they have. Their MCP server hashes it locally.
  4. Cryptair compares hashes server-side:
    • Match → both parties' agreement is written to Hedera. Permanent record.
    • Mismatch → tamper event is written to Hedera. Both parties are notified.

Agent B does not need a Cryptair account to participate. If Agent B supplies an email when submitting, an account is auto-provisioned for them and the API key is silently persisted by their MCP server — so they can initiate their own attestations later without any signup friction.

Why MCP, Not Skills

This server is cross-vendor by design. Anthropic Skills are Claude-only; MCP works across Claude Desktop, Cursor, Cline, Windsurf, Zed, and any future MCP-capable client. One install, every agent ecosystem.

Environment Variables

VariablePurposeDefault
CRYPTAIR_API_KEYPre-configured API key. Skips register_agent.(none)
CRYPTAIR_EMAILEmail used for submit_attestation auto-provisioning if omitted from the call.(none)
CRYPTAIR_BASE_URLAPI base URL. Override for self-hosted or staging.https://www.cryptair.io

Development

bash
git clone https://github.com/Syronius/cryptair-mcp-servercd mcp-servernpm installnpm run buildnpm start

The server speaks JSON-RPC over stdio. To test manually, send tools/list to confirm all six tools are registered.

Free Tier & Pricing

The Cryptair free tier currently lets every account originate a small number of attestations per month. Counterparty completion (submit_attestation) is always free. Heavy users can top up with prepaid credits — see cryptair.io/pricing for details.

License

MIT

来源:README.md,提交 6142877

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分