Ethereum Keystore Encryption

Keystore MCP 服务

一个用于以太坊 keystore 加密、解密和管理的 Model Context Protocol (MCP) 服务，遵循 Web3 Secret Storage Definition Version 3 标准。

功能

工具（9）

• encrypt_keystore - 将私钥加密为 Web3 Secret Storage V3 格式
• decrypt_keystore - 解密 keystore 以恢复私钥
• save_keystore_file - 使用标准以太坊命名保存 keystore
• load_keystore_file - 加载并校验 keystore 文件
• get_keystore_info - 无需解密即可提取元数据
• validate_keystore - 校验 keystore 结构
• change_keystore_password - 修改密码并可选升级 KDF
• batch_encrypt_keystores - 批量加密多个钱包
• keystore_to_private_key_file - 导出已解密的私钥（危险）

资源（4）

• keystore://specification - Web3 Secret Storage V3 规范
• keystore://security-guide - 安全最佳实践
• keystore://kdf-comparison - Scrypt 与 PBKDF2 对比
• keystore://examples/{type} - 示例 keystore

提示词（4）

• secure_wallet_backup - 引导式备份创建
• keystore_migration - 从旧格式迁移
• keystore_recovery - 恢复协助
• keystore_security_audit - 安全审计工作流

安装

pip install -e .

# Or with dev dependencies
pip install -e ".[dev]"

使用

运行服务

keystore-mcp-server

Claude Desktop 配置

{
  "mcpServers": {
    "keystore": {
      "command": "keystore-mcp-server"
    }
  }
}

加密标准

Web3 Secret Storage V3

• KDF：scrypt（推荐）或 pbkdf2
• Cipher：AES-128-CTR
• MAC：Keccak-256
• UUID：版本 4

默认 Scrypt 参数

参数	值	描述
N	262144 (2^18)	CPU/内存开销
r	8	块大小
p	1	并行度
dklen	32	派生密钥长度

默认 PBKDF2 参数

参数	值	描述
c	262144	迭代次数
prf	hmac-sha256	PRF
dklen	32	派生密钥长度

安全

⚠️ 重要安全注意事项：

1. 切勿分享 keystore 密码 - 与私钥同等对待
2. 使用强密码 - 至少 12 个字符，包含大小写字母、数字、符号
3. 安全存储文件 - 文件以 0600 权限创建
4. 气隙隔离操作 - 高价值钱包请离线使用
5. 备份 keystore - 将加密备份存储在多个位置

示例

加密私钥

result = await encrypt_keystore(
    private_key="0x...",
    password="strong-password-123",
    kdf="scrypt"
)

解密 Keystore

result = await decrypt_keystore(
    keystore=keystore_json,
    password="strong-password-123"
)

保存 Keystore 文件

result = await save_keystore_file(
    keystore=keystore_json,
    directory="./keystores"
)
# Creates: UTC--2024-01-15T10-30-00.000Z--address.json

测试

pytest tests/ -v

许可证

MIT License