Ethereum Wallet Generator

Ethereum Wallet MCP Server

一个提供 Ethereum 钱包生成和 HD 钱包功能的 Model Context Protocol (MCP) 服务。该服务使 Claude 等 AI 助手能够安全地生成 Ethereum 钱包、处理 BIP39 助记词，并从单个助记词派生多个账户。

功能

工具

• generate_wallet - 生成一个新的随机 Ethereum 钱包
• generate_wallet_with_mnemonic - 生成带 BIP39 助记词的钱包
• restore_wallet_from_mnemonic - 从现有助记词恢复钱包
• restore_wallet_from_private_key - 从私钥恢复钱包
• derive_multiple_accounts - 派生多个 HD 钱包账户
• generate_vanity_address - 生成匹配指定模式的地址

提示词

• create_secure_wallet - 引导式安全钱包创建
• backup_wallet_guide - 钱包备份说明
• recover_wallet_help - 钱包恢复协助

资源

• wallet://documentation/bip39 - BIP39 标准文档
• wallet://documentation/derivation-paths - HD 派生路径文档
• wallet://wordlist/{language} - 按语言分类的 BIP39 词表

安装

# Install from source
pip install -e .

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

用法

运行服务

# Run directly
ethereum-wallet-mcp

# Or via Python
python -m ethereum_wallet_mcp.server

Claude Desktop 配置

添加到你的 Claude Desktop 配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "ethereum-wallet": {
      "command": "ethereum-wallet-mcp"
    }
  }
}

交互示例

User: "Generate a new Ethereum wallet for me"
→ Returns: address, private_key, public_key

User: "Create a wallet with a 24-word seed phrase"
→ Returns: address, private_key, mnemonic (24 words), derivation_path

User: "Restore my wallet from this seed: abandon abandon abandon..."
→ Returns: restored wallet details

User: "Derive 10 accounts from my seed phrase"
→ Returns: list of 10 accounts with addresses and keys

User: "Generate a vanity address starting with 'cafe'"
→ Returns: matching address with generation stats

安全注意事项

⚠️ 重要安全警告：

1. 切勿分享私钥或助记词 - 这些信息可完全访问资金
2. 此服务不会持久化敏感数据 - 密钥仅在操作期间存在于内存中
3. 真实资金请使用硬件钱包 - 软件钱包本质上安全性较低
4. 靓号地址存在风险 - 切勿用于高价值存储
5. 独立验证地址 - 始终仔细核对派生出的地址

开发

运行测试

pytest tests/ -v

代码格式化

black src/ tests/
isort src/ tests/

类型检查

mypy src/

API 参考

工具：generate_wallet

生成一个新的随机 Ethereum 钱包，不含助记词。

参数： 无

返回：

• address (str)：带校验和的 Ethereum 地址
• private_key (str)：十六进制编码的私钥（带 0x 前缀）
• public_key (str)：十六进制编码的公钥

工具：generate_wallet_with_mnemonic

生成带 BIP39 助记词的新钱包。

参数：

• word_count (int，可选)：12、15、18、21 或 24。默认：12
• language (str，可选)：助记词语言。默认："english"
• passphrase (str，可选)：BIP39 密码短语。默认：""
• derivation_path (str，可选)：HD 路径。默认："m/44'/60'/0'/0/0"

返回：

• address、private_key、public_key
• mnemonic (str)：以空格分隔的助记词
• derivation_path (str)：所使用的路径
• passphrase_used (bool)：是否应用了密码短语

工具：restore_wallet_from_mnemonic

从现有 BIP39 助记词恢复钱包。

参数：

• mnemonic (str，必填)：以空格分隔的助记词
• passphrase (str，可选)：BIP39 密码短语。默认：""
• derivation_path (str，可选)：HD 路径。默认："m/44'/60'/0'/0/0"

返回： 与 generate_wallet_with_mnemonic 相同（不含 mnemonic 字段）

工具：restore_wallet_from_private_key

从私钥恢复钱包。

参数：

• private_key (str，必填)：十六进制私钥（带或不带 0x 前缀）

返回：

• address、private_key（规范化）、public_key

工具：derive_multiple_accounts

从单个助记词派生多个账户。

参数：

• mnemonic (str，必填)：BIP39 助记词
• count (int，可选)：账户数量（1-100）。默认值：5
• start_index (int，可选)：起始索引。默认值：0
• passphrase (str，可选)：BIP39 密码短语。默认值：""
• base_path (str，可选)：基础 HD 路径。默认值："m/44'/60'/0'/0"

返回：

• accounts (list)：{index, derivation_path, address, private_key, public_key} 的列表
• total_derived (int)：已派生的账户数量
• base_path (str)：使用的基础路径

工具：generate_vanity_address

生成与靓号模式匹配的地址。

参数：

• prefix (str，可选)：0x 之后所需的前缀（十六进制字符）
• suffix (str，可选)：所需的后缀（十六进制字符）
• case_sensitive (bool，可选)：是否精确匹配大小写。默认值：false
• timeout_seconds (int，可选)：最长搜索时间。默认值：60

返回：

• address、private_key、public_key
• pattern_matched (str)：匹配到的模式
• attempts (int)：已尝试的地址数量
• time_seconds (float)：耗时
• difficulty (int)：预估的 1/N 难度

许可证

MIT License

贡献

欢迎贡献！请阅读贡献指南并提交拉取请求。