cryptair-mcp-server

Cryptair MCP サーバー

AI エージェント向けの暗号学的証明を、ネイティブな MCP ツールとして提供します。

MCP に対応したエージェント（Claude Desktop、Cursor、Cline、Windsurf、Zed など）なら、Hedera Hashgraph 上のオンチェーン記録により、合意を証明し、ドキュメントを認証し、相手方の申告を検証できます。設定不要ですぐに使えます。エージェントは自動で登録して、メール認証や人間による登録手続きなしに、すぐ証明を開始できます。

できること

Cryptair を使うと、2 つのエージェント（またはエージェントと人間）が、特定の時点で同じデジタル成果物に合意したことを証明できます。確認された合意はすべて SHA-256 ハッシュとして Hedera Hashgraph に記録され、永続的で第三者が検証可能な証明記録が作成されます。

この MCP サーバーは、エージェントの考え方に沿った 6 つのツールを提供します。

ツール	呼び出すタイミング
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 キーをすでにお持ちの場合は、環境変数で指定すると、エージェントによる登録を省略できます。

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

それ以外の場合、エージェントは認証が初めて必要になったときに register_agent を呼び出します。API キーは今後の利用に備えて ~/.cryptair/credentials.json に通知なしで保存されます。

エージェントへのプロンプト例

インストール後、次のようなプロンプトを試してみてください。

「~/Documents/proposal-v3.pdf の内容を証明して、タイムスタンプ付きの証明記録を作成してください。」

「~/Documents/contract.pdf を Acme Corp に送り、正式に受領確認してもらってください。リンクを生成してください。」

「Acme から次の Cryptair リンクが届きました：https://www.cryptair.io/attest/abc...?token=xyz。~/Downloads/contract.pdf が相手の送ったファイルと一致することを確認してください。」

「証明セッション abc-123 のステータスは？」

エージェントは適切なツールを選び、認証情報の初期設定も自動的に処理します。

証明の仕組み

単独での証明（certify_document）

1. MCP サーバーがファイルをローカルで SHA-256 ハッシュ化します。
2. ハッシュが Cryptair に送信され、Cryptair が Hedera Consensus Service のトピックに書き込みます。
3. Hedera トランザクション ID、コンセンサスのタイムスタンプ、公開証明書 URL が返されます。
4. 誰でもファイルを再度ハッシュ化し、verify_document を呼び出して検証できます。ファイルの内容がマシンの外部に送信されることはありません。

2 者間での証明（initiate_attestation + submit_attestation）

1. エージェント A がドキュメントのハッシュと相手方の名前を指定して開始します。Cryptair は共有可能な URL を返します。
2. エージェント A はメールや Slack など、任意のチャネルを通じてエージェント B に URL を送ります。
3. エージェント B は URL を開き、自分が持っているファイルを送信します。エージェント B の MCP サーバーがファイルをローカルでハッシュ化します。
4. Cryptair がサーバー側でハッシュを比較します。
   • 一致 → 両者の合意が Hedera に記録されます。永続的な記録になります。
   • 不一致 → 改ざんイベントが Hedera に記録されます。両者に通知されます。

エージェント B は参加するために Cryptair アカウントを作成する必要はありません。送信時にエージェント B がメールアドレスを入力すると、アカウントが自動的に作成され、API キーはエージェント B の MCP サーバーによって通知なしに保存されます。そのため、登録の手間なく、後から自身で証明を開始できます。

MCP を Skills ではなく選ぶ理由

このサーバーは、ベンダーを問わず利用できるように設計されています。Anthropic Skills は Claude 専用ですが、MCP は Claude Desktop、Cursor、Cline、Windsurf、Zed、そして今後登場するあらゆる MCP 対応クライアントで動作します。1 回のインストールで、あらゆるエージェントのエコシステムで利用できます。

環境変数

変数	用途	デフォルト
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

サーバーは stdio 経由で JSON-RPC を使用します。手動でテストするには、tools/list を送信して 6 つのツールすべてが登録されていることを確認します。

無料プランと料金

Cryptair の無料プランでは、現在、すべてのアカウントで毎月、少数のアテステーションを発行できます。相手側による完了（submit_attestation）は常に無料です。利用頻度の高いユーザーは、前払いクレジットを追加できます。詳しくは cryptair.io/pricing をご覧ください。

ライセンス

MIT