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