MCP EVM Signer

MCP EVM Signer

Infura を使用して Ethereum の秘密鍵を管理し、スマートコントラクトをデプロイするための Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude for Desktop やその他の MCP クライアントから、EVM 互換のブロックチェーンを操作できます。

機能

• 🔑 Ethereum の秘密鍵をローカルで安全に保存、管理
• 🔌 ブロックチェーンとのやり取りに Infura を使用
• 📝 コンパイル済みの ABI とバイトコードからスマートコントラクトをデプロイ
• ✍️ トランザクションに署名して送信
• 💰 アカウント残高とトランザクション履歴を表示
• 🔍 ブロックチェーンデータを照会し、デプロイ済みのコントラクトを操作

クイックスタート

前提条件

• Node.js v16 以上
• API キーを取得済みの Infura アカウント
• Claude for Desktop アプリのインストール

インストール

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

   git clone https://github.com/zhangzhongnan928/mcp-evm-signer.git
   cd mcp-evm-signer
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 環境変数を設定します：

   cp .env.example .env
   

   .env ファイルを編集して、Infura API キーを追加し、その他の設定を行います。

Claude for Desktop との連携

1. Claude for Desktop の設定にサーバーを追加します：

{
  "mcpServers": {
    "evm-signer": {
      "command": "node",
      "args": ["/path/to/mcp-evm-signer/build/index.js"],
      "env": {
        "INFURA_API_KEY": "your_infura_api_key_here",
        "DEFAULT_NETWORK": "sepolia",
        "ENCRYPT_KEYS": "true",
        "KEY_PASSWORD": "your_secure_password_here"
      }
    }
  }
}

2. Claude for Desktop を再起動します

3. Claude にスマートコントラクトのデプロイ、残高の確認、EVM ブロックチェーンの操作を依頼できるようになります

利用可能なツール

MCP EVM Signer サーバーは、Claude で使用できる以下のツールを提供します：

ウォレット管理

• create-wallet：新しい Ethereum ウォレットを作成
• import-wallet：秘密鍵を使って既存のウォレットをインポート
• list-wallets：保存済みのすべてのウォレットを一覧表示

ブロックチェーン操作

• check-balance：アドレスの ETH 残高を確認
• get-transactions：アドレスの最近のトランザクションを取得
• send-transaction：アドレスに ETH を送信

スマートコントラクトとのやり取り

• deploy-contract：ABI とバイトコードからスマートコントラクトをデプロイ
• call-contract：読み取り専用のコントラクトメソッドを呼び出す
• execute-contract：状態を変更するコントラクトメソッドを実行

使用例

以下は、Claude でこれらのツールを使用する例です：

ウォレットの作成

Claude に次のように依頼できます：

Could you create a new Ethereum wallet for me using the evm-signer tools?

残高の確認

Claude に次のように依頼できます：

Can you check the balance of my Ethereum wallet 0x1234...5678 on the Sepolia network?

ERC-20 トークンのデプロイ

ERC-20 トークンコントラクトのデプロイと操作の詳しい手順については、ERC-20 token example を参照してください。

セキュリティに関する注意事項

• 秘密鍵はお使いのマシンにローカル保存されます
• パスワードを使って鍵を暗号化できます
• サーバーは MCP プロトコルを通じてのみ機能を公開します
• Claude for Desktop で承認する前に、必ずトランザクションを確認してください
• 初めて使用する際は、Sepolia や Goerli などのテストネットを使用してください

ドキュメント

詳しいドキュメントについては、以下を参照してください：

• 使用ガイド：詳しい使用手順と例
• 例：ワークフローとコントラクトデプロイのサンプル

プロジェクト構成

mcp-evm-signer/
├── src/                  # Source code
│   ├── config.ts         # Configuration management
│   ├── crypto.ts         # Key management utilities
│   ├── ethereum.ts       # Ethereum interaction functions
│   └── index.ts          # Main MCP server implementation
├── keys/                 # Storage for wallet keys (gitignored)
├── examples/             # Example usage patterns
├── .env.example          # Example environment variables
└── ...                   # Project configuration files

開発

このプロジェクトに貢献するには：

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更を加えます
4. 変更をコミットします（git commit -m 'Add some amazing feature'）
5. ブランチにプッシュします（git push origin feature/amazing-feature）
6. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。