CipherHUB MCP Server

Production-grade cryptography toolkit exposing 31 cryptographic operations via MCP (Model Context Protocol).

Overview

CipherHUB is a cryptography toolkit that enables AI agents to perform cryptographic operations without implementing algorithms themselves. It covers:

• Classical Algorithms: AES, RSA, ECC (SECP256R1/384R1/521R1, X25519, Ed25519)
• Chinese National Standards: SM2, SM3, SM4, ZUC
• Post-Quantum Cryptography: ML-KEM (FIPS 203), ML-DSA (FIPS 204), X25519+ML-KEM-768 Hybrid KEX
• Interoperability: Certified with AWS KMS (64/64) and Tencent Cloud KMS (39/39)

Quick Start

MCP Endpoint

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

Protocol

• Type: Streamable HTTP
• Format: JSON-RPC 2.0
• Stateless: No session required

Example: Call a Tool

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": ["SHA256"]
      }
    },
    "id": 1
  }'

Example: List Resources

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": "resources/list",
    "id": 1
  }'

Tools

Hash Functions

Tool	Description
hash_sum	SHA-1/224/256/384/512, SM3
hmac_sum	HMAC with all hash algorithms

Symmetric Encryption

Tool	Description
block_cipher_encrypt / block_cipher_decrypt	AES-128/256, SM4 (CBC mode)
stream_cipher_encrypt / stream_cipher_decrypt	AES-256-GCM, ChaCha20-Poly1305, SM4-GCM
zuc_cipher	ZUC-128 stream cipher

Asymmetric Cryptography

Tool	Description
rsa_generate_key	Generate RSA key pair (2048/3072/4096 bits)
rsa_encrypt / rsa_decrypt	RSA encryption/decryption
rsa_sign / rsa_verify	RSA signatures
ecc_generate_key	Generate ECC key pair
ecc_sign / ecc_verify	ECDSA/EdDSA signatures
ecc_key_exchange	ECDH + HKDF key agreement

Chinese National Standards

Tool	Description
sm2_generate_key	Generate SM2 key pair
sm2_encrypt / sm2_decrypt	SM2 encryption
sm2_sign / sm2_verify	SM2 signatures

Post-Quantum Cryptography

Tool	Description
ml_kem_keygen	ML-KEM key generation
ml_kem_encapsulate / ml_kem_decapsulate	ML-KEM encapsulation/decapsulation
ml_dsa_keygen	ML-DSA key generation
ml_dsa_sign / ml_dsa_verify	ML-DSA signatures
hybrid_kex_keygen	X25519+ML-KEM-768 hybrid key exchange

Utility

Tool	Description
generate_random_data	Generate secure random bytes
data_padding / data_unpadding	PKCS#7 padding

Resources

URI	Description
cipherhub://algorithms	Complete algorithm catalog
cipherhub://tool-categories	Tool categorization
cipherhub://interop/aws-kms	AWS KMS interoperability report
cipherhub://interop/tencent-kms	Tencent Cloud KMS interoperability report
cipherhub://channel-implementation	SDK channel protocol guide

Client Configuration

Claude Desktop

Add to your Claude Desktop config:

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

Cursor IDE

Add to your Cursor settings.

Custom Client

Use any MCP-compatible client with the endpoint URL.

API Documentation

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

Web Interface

Interactive web UI available at: https://tools.cipherhub.cloud

Author

Yang X. CHEN

• Blog: https://cipherhub.cloud
• GitHub: @bowenerchen

License

MIT License