CipherHUB Cryptography Toolkit

CipherHUB MCP Server

MCP（Model Context Protocol）経由で55 種類の暗号操作を提供する、本番環境向けの暗号ツールキットです。Yang X. CHEN が開発・運用しており、このサービスの設計上の判断については cipherhub.cloud のブログで紹介しています。

概要

CipherHUB を使うと、AI エージェントはアルゴリズムを自分で実装することなく、暗号操作を実行できます。以下に対応しています。

• 従来のアルゴリズム：AES（CBC/GCM/CTR/XTS）、ChaCha20-Poly1305、RSA、ECC（SECP256R1/384R1/521R1、X25519、Ed25519）、SHA-2 ファミリー、SHAKE
• 中国国家標準（国密）：SM2、SM3、SM4、ZUC-128、ID ベース暗号方式 SM9（GM/T 0044）
• 耐量子暗号：ML-KEM（FIPS 203）、ML-DSA（FIPS 204）、X25519+ML-KEM-768 ハイブリッド KEX
• 証明書と構造化暗号メッセージ：X.509 の解析と検証、CMS SignedData および EnvelopedData（RFC 5652）、COSE_Sign1（RFC 9052）、CBOR（RFC 8949）、ASN.1/DER の解析
• 相互運用性：3 つの独立したスタックで検証済み：AWS KMS（70/70）、Tencent Cloud KMS（39/39）、OpenSSL 3.6（148/154 — 6 件をスキップ、失敗 0 件）

クイックスタート

MCP エンドポイント

https://tools.cipherhub.cloud/cipherhub/mcp

プロトコル

• タイプ：ストリーマブル HTTP（MCP プロトコルリビジョン 2025-03-26）
• 形式：JSON-RPC 2.0
• ステートレス：セッション、ハンドシェイク、API キーは不要です。各リクエストは単独の POST です
• デプロイ済みバージョン：1.11.0

例：ツールを呼び出す

curl -X POST https://tools.cipherhub.cloud/cipherhub/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "hash_sum",
      "arguments": {
        "plain_in_hex": "48656c6c6f",
        "required_hash_modes": ["Sha384"]
      }
    },
    "id": 1
  }'

ツールのペイロードは、result.content[0].text 内の JSON 文字列です。

{
  "code": "success",
  "Results": {
    "Sha384": {
      "hash_sum_in_hex": "3519fe5ad2c596efe3e276a6f351b8fc0b03db861782490d45f7598ebd0ab5fd5520ed102f38c4a5ec834e98668035fc",
      "hash_length": 48
    }
  }
}

規約にご注意ください。バイナリ入力と出力は 16 進数文字列（*_in_hex フィールド）で受け渡し、アルゴリズム名には TitleCase の列挙値（Sha384、Sm3）を使用します。SHA-384 はスキーマで拒否されます。

実行可能な例については、examples/curl_examples.sh と examples/quickstart.py（Python 標準ライブラリのみ）をご覧ください。

ツール

ハッシュと MAC

ツール	説明
hash_sum	バッチダイジェスト：SHA-1/224/256/384/512、SM3、SHAKE128/256
hmac_sum	同じハッシュファミリーを使った HMAC（SHAKE を除く）

鍵導出

ツール	説明
key_derivation	HKDF（RFC 5869）、SM3-KDF（GB/T 32918）、PBKDF2-SM3（RFC 8018）

乱数とユーティリティ

ツール	説明
hello	接続確認。client_msg をそのまま返します
generate_random_data	CSPRNG バイト列（1 回あたり 1～128 バイト）
data_padding	PKCS#7 によるパディング／パディング解除

共通鍵暗号

ツール	説明
block_cipher	AES-128/256-CBC、SM4-CBC
stream_cipher	AEAD：AES-256-GCM、ChaCha20-Poly1305、SM4-GCM
ctr_cipher	AES-256-CTR、SM4-CTR カウンターモード
xts_cipher	AES-XTS（IEEE 1619 / NIST SP 800-38E）
zuc_cipher	ZUC-128 ストリーム暗号（3GPP、4G/5G モバイル通信）

RSA

ツール	説明
generate_rsa	RSA 鍵ペアを生成（2048/3072/4096 ビット）
rsa_encryption / rsa_decryption	RSA 公開鍵暗号化、秘密鍵復号
rsa_sign / rsa_verify	RSA 署名

ECC

ツール	説明
generate_ecc	ECC 鍵ペアを生成（SECP256R1/384R1/521R1、X25519、Ed25519）
ecc_key_exchange	ECDH + HKDF 鍵合意
ecc_key_sign / ecc_key_verify	ECDSA（SECP*）および EdDSA（ED25519）署名

SM2 — 中国国家標準曲線

ツール	説明
generate_sm2	SM2（SM2P256V1）鍵ペアを生成します
sm2_encryption / sm2_decryption	SM2 公開鍵暗号化
sm2_sign / sm2_verify	SM2 署名
sm2_private_key_structure_parse	暗号化された SM2 秘密鍵の ASN.1 表示
sm2_public_key_to_hex	PEM 公開鍵 → 生の非圧縮点（04‖X‖Y）

SM9 — ID ベース暗号（GM/T 0044）

ツール	説明
generate_sm9	KGC マスター鍵ペア（Sign または Enc）を生成します
sm9_extract_key	KGC が ID に対応するユーザー秘密鍵を発行します
sm9_encryption / sm9_decryption	ID を指定して暗号化し、ユーザー鍵で復号します
sm9_sign / sm9_verify	ID ベースの署名

耐量子暗号

ツール	説明
ml_kem_keygen	ML-KEM 鍵生成（FIPS 203）
ml_kem_encap / ml_kem_decap	ML-KEM のカプセル化／カプセル化解除
ml_dsa_keygen	ML-DSA 鍵生成（FIPS 204）
ml_dsa_sign / ml_dsa_verify	ML-DSA 署名
ml_dsa_compute_mu	単独の 64 バイト mu 計算（FIPS 204 §6.2）
hybrid_kex	X25519 + ML-KEM-768 ハイブリッド鍵交換の手順

X.509 証明書

ツール	説明
cert_parse	PEM 証明書を解析します（X.509 と GM SM2 のデュアルパス）
cert_verify	エンドエンティティ証明書を CA に照らして検証します

構造化データ

ツール	説明
cbor_encode / cbor_decode	JSON ↔ CBOR（RFC 8949）。デコード結果にはフィールドごとのツリーが含まれます
asn1_parse	任意の ASN.1/BER バイト列を TLV 分解し、DER 判定を行います（X.690）
der_encode	JSON ノード DSL → DER バイト列（X.690）

COSE と CMS

ツール	説明
cose_sign1_sign / cose_sign1_verify / cose_sign1_parse	COSE_Sign1 の構築、検証、分解（RFC 9052/9053）
cms_signed_sign / cms_signed_verify	CMS SignedData の署名と検証（RFC 5652 §5）
cms_enveloped_encrypt / cms_enveloped_decrypt / cms_enveloped_parse	CMS EnvelopedData / authEnvelopedData（RFC 5652 §6、RFC 5083）

プロンプト

prompts/list 経由で提供される、すぐに使える 6 つのエージェントワークフローです。

プロンプト	目的
pqc_migration_assessment	耐量子移行への準備状況を評価します
algorithm_recommendation	ユースケースに応じたアルゴリズムを選定します
e2e_encryption_flow	エンドツーエンド暗号化の全手順を確認します
sign_verify_workflow	鍵ペアを生成し、署名してから検証します
verify_key_pair	鍵ペアが一致することを確認します（RSA、ECC、SM2）
hybrid_kex_demo	X25519 + ML-KEM-768 のハイブリッド交換デモ

リソース

URI	説明
cipherhub://algorithms	完全なアルゴリズムカタログ
cipherhub://tool-categories	ツールの分類
cipherhub://mcp-usage-guide	これらの MCP ツールを使用する AI エージェント向けの完全なガイド
cipherhub://interop/aws-kms	AWS KMS 相互運用性レポート（70/70 件成功）
cipherhub://interop/tencent-kms	Tencent Cloud KMS 相互運用性レポート（39/39 件成功）
cipherhub://interop/openssl36	OpenSSL 3.6 相互運用性レポート（148/154 件成功）
cipherhub://benchmark-report	すべての操作のパフォーマンスベンチマーク
cipherhub://channel-implementation	SDK チャネルプロトコルのリファレンス実装

エージェントスキル

すぐに使える Agent Skills パッケージが skills/cipherhub-crypto/ にあります。CipherHUB を利用するタイミングと呼び出し方を、SKILL.md 互換のあらゆるエージェント（Claude Code など）に教えます。MCP サーバーを登録する方法と、通常の HTTP を使う方法があります。インストール方法：

cp -r skills/cipherhub-crypto ~/.claude/skills/

クライアントの設定

Claude Code

claude mcp add --scope user --transport http cipherhub https://tools.cipherhub.cloud/cipherhub/mcp

Claude Desktop

Claude Desktop の設定に追加します：

{
  "mcpServers": {
    "cipherhub": {
      "url": "https://tools.cipherhub.cloud/cipherhub/mcp"
    }
  }
}

カスタムクライアント

エンドポイント URL を使用して、MCP 互換のクライアントを利用できます。

API ドキュメント

• OpenAPI: https://tools.cipherhub.cloud/.well-known/openapi.yaml
• llms.txt: https://tools.cipherhub.cloud/llms.txt

Web インターフェース

インタラクティブな Web UI をご利用いただけます: https://tools.cipherhub.cloud

作者

Yang X. CHEN

• ブログ: https://cipherhub.cloud — このツールキットの開発の背景にあるストーリー: アルゴリズムの選択、GmSSL の統合、相互運用性テスト、耐量子移行に関するメモ
• GitHub: @bowenerchen

ライセンス

MIT ライセンス