Ethereum Wallet Generator

Ethereum Wallet MCP サーバー

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): 16 進数エンコードされた秘密鍵（0x プレフィックス付き）
• public_key (str): 16 進数エンコードされた公開鍵

ツール: 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, 必須): 16 進数の秘密鍵（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 以降に希望するプレフィックス (16 進文字)
• suffix (str, 任意): 希望するサフィックス (16 進文字)
• 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 ライセンス

コントリビューション

コントリビューションを歓迎します! コントリビューションガイドラインをお読みのうえ、プルリクエストを送信してください。