CipherHUB Cryptography Toolkit

CipherHUB MCP 服务

面向生产环境的密码学工具包，通过 MCP（模型上下文协议）提供 55 种密码学操作。由 Yang X. CHEN 构建并运营——该服务背后的工程决策已发布在 cipherhub.cloud 博客上。

概览

CipherHUB 支持 AI Agent 执行密码学操作，而无需自行实现算法。涵盖：

• 经典算法：AES（CBC/GCM/CTR/XTS）、ChaCha20-Poly1305、RSA、ECC（SECP256R1/384R1/521R1、X25519、Ed25519）、SHA-2 系列、SHAKE
• 中国国家标准（国密）：SM2、SM3、SM4、ZUC-128、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 解析
• 互操作性，已通过三个独立技术栈验证：AWS KMS（70/70）、Tencent Cloud KMS（39/39）、OpenSSL 3.6（148/154——跳过 6 项，失败 0 项）

快速开始

MCP 端点

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

协议

• 类型：Streamable 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
    }
  }
}

请注意以下约定：二进制输入和输出以十六进制字符串传输（*_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–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 — 基于标识的密码学（GM/T 0044）

工具	描述
generate_sm9	生成 KGC 主密钥对（Sign 或 Enc）
sm9_extract_key	KGC 为某个标识签发用户私钥
sm9_encryption / sm9_decryption	加密到某个标识，并使用用户密钥解密
sm9_sign / sm9_verify	基于标识的签名

后量子密码学

工具	描述
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 提供的六个现成 Agent 工作流：

提示词	用途
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	AI Agent 使用这些 MCP 工具的完整指南
cipherhub://interop/aws-kms	AWS KMS 互操作性报告（70/70 通过）
cipherhub://interop/tencent-kms	腾讯云 KMS 互操作性报告（39/39 通过）
cipherhub://interop/openssl36	OpenSSL 3.6 互操作性报告（148/154 通过）
cipherhub://benchmark-report	所有操作的性能基准测试
cipherhub://channel-implementation	SDK 通道协议参考实现

Agent 技能包

现成的 Agent Skills 包位于 skills/cipherhub-crypto/。它会教任何兼容 SKILL.md 的 Agent（Claude Code 等）何时使用 CipherHUB 以及如何调用它，可通过注册 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"
    }
  }
}

自定义客户端

使用任意兼容 MCP 的客户端和端点 URL。

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 License