MCP Crypto Wallet EVM

🚀 MCP イーサリアムウォレットサーバー（EVM）

このリポジトリには、モデルコンテキストプロトコル（MCP）サーバーが含まれています。このサーバーは、Claude に対して ethers.js v5 を通じて Ethereum および EVM 互換ブロックチェーンの操作を行う機能を提供します。このサーバーにより、Claude はウォレットの作成、残高の確認、トランザクションの送信、スマートコントラクトとのやり取りなどの操作を実行できます。

📋 概要

MCP サーバーは、Claude に以下のツールを提供します。

✨ ウォレットの作成と管理

• wallet_create_random：新しいランダムなウォレットを作成します。
• wallet_from_private_key：秘密鍵からウォレットを作成します。
• wallet_from PublicKey：公開鍵からウォレットを作成します。
• wallet_from_mnemonic：ニーモニックフレーズからウォレットを作成します。

💼 ウォレット操作

• ウォレットの復元：既存のウォレットを復元します。
• ウォレットのエクスポート：ウォレット情報をエクスポートします。
• ウォレットのインポート：外部のウォレットをインポートします。

💰 資産操作

• 資産残高の照会：ウォレット内のトークンと ETH の残高を確認します。
• トークンの転送：他のアドレスにトークンを送信します。
• ETH の転送：他のアドレスに ETH を送信します。

🤝 コントラクトのやり取り

• コントラクトのデプロイ：ブロックチェーン上に新しいスマートコントラクトをデプロイします。
• コントラクトの呼び出し：デプロイされたスマートコントラクトとやり取りします。
• トランザクション状態の照会：トランザクションの状態と詳細情報を確認します。

🛠️ 前提条件

1. Node.js と npm をインストールします：

   https://nodejs.org/
   

2. ethers.js をインストールします：

   npm install ethers
   

3. MetaMask をダウンロードしてインストールします：

   https://metamask.io/
   

📦 インストール

🔸 方法 1：npm パッケージを使用する

1. リポジトリをクローンします：

   git clone https://github.com/dcSpark/mcp-cryptowallet-evm.git
   

2. ディレクトリに移動します：

   cd mcp-cryptowallet-evm
   

3. 依存関係をインストールしてビルドします：

   npm install
   npm run build
   

4. サーバーを起動します：

   node build/index.js
   

🔸 方法 2：ローカルで実行する

1. リポジトリをクローンした後、直接実行します：

   node src/index.js
   

⚙️ 設定

🔐 環境変数に追加する

以下の内容を ~/.env ファイルに追加します：

WALLET_PROVIDER=metamask
metamask_rpc_url=https://eth-mainnet.alchemyapi.io/YOUR_API_KEY

📄 ウォレット設定を行う

wallet.config.js ファイルを作成します：

module.exports = {
  mnemonic: 'your 12-word mnemonic',
  accounts: ['0xYourAccountAddress'],
  hdPath: "m/44'/60'/0'/0",
  chainId: 1,
  gasPrice: 2000000000,
  gasLimit: 200000,
  confirmations: 3
}

💻 使用例

Claude Desktop を再起動すると、Claude は MCP サーバーを介してイーサリアムブロックチェーンと直接やり取りできます。例えば：

1. 新しいウォレットを作成する：

   新しいイーサリアムウォレットを作成してくれますか？
   

2. 残高を確認する：

   0x742d35Cc6634C0532925a3b844Bc454e4438f44e の残高はいくらですか？
   

3. トランザクションを送信する：

   0x742d35Cc6634C0532925a3b844Bc454e4438f44e に 0.1 ETH を送ってくれますか？
   

🚧 開発

➕ 新しいツールを追加する

MCP サーバーに新しいツールを追加するには：

1. src/tools.ts でツールを定義します。
2. 対応する処理関数を作成します。
3. ハンドラーを handlers オブジェクトに追加します。

🏗️ ビルドする

npm run build

📄 ライセンス

MIT