Ethereum Wallet (EVM)

🚀 MCP 加密錢包 EVM

本項目提供了一個模型上下文協議 (MCP) 服務器，藉助該服務器，Claude 能夠利用 ethers.js v5 對以太坊及 EVM 兼容區塊鏈進行操作，如創建錢包、查詢餘額、發送交易和與智能合約交互等。

🚀 快速開始

此 MCP 服務器讓 Claude 具備了訪問以太坊和 EVM 兼容區塊鏈操作的能力。完成配置後，重啟 Claude Desktop，Claude 即可使用相關工具。

✨ 主要特性

MCP 服務器為 Claude 提供了豐富的工具，涵蓋錢包創建管理、區塊鏈操作、交易處理和智能合約交互等方面：

錢包創建和管理

• wallet_create_random：使用隨機私鑰創建新錢包
• wallet_from_private_key：從私鑰創建錢包
• wallet_from_mnemonic：從助記詞短語創建錢包
• wallet_from_encrypted_json：通過解密加密的 JSON 錢包創建錢包
• wallet_encrypt：對錢包進行加密

區塊鏈方法

• eth_getBalance：檢查指定地址的以太坊餘額
• eth_sendTransaction：發送以太坊交易
• eth_call：執行讀寫智能合約操作
• eth_sign：使用錢包地址對消息進行簽名

交易方法

• transaction_request：創建交易請求
• transaction_send：發送交易到區塊鏈
• transaction_receipt：獲取交易收據
• transaction_cancel：取消未確認的交易

智能合約

• contract_deploy：部署新智能合約
• contract_interact：與現有智能合約交互
• abi_decode：解碼智能合約ABI數據
• abi_encode：將數據編碼為ABI格式

📦 安裝指南

先決條件

要使用此 MCP 服務器，您需要：

1. 安裝 Node.js 和 npm
2. 安裝 ethers.js 庫：

   npm install ethers
   

安裝步驟

快速安裝

npm install mcp-cryptowallet-evm

其他安裝方式

若上述命令不可用，您可以手動克隆倉庫並運行：

git clone https://github.com/your-organization/mcp-cryptowallet-evm.git
cd mcp-cryptowallet-evm
npm install

📚 詳細文檔

配置

環境變量

運行服務器前，需設置以下環境變量：

• ETH_PROVIDER_URL：指定的以太坊節點 URL
• PRIVATE_KEY：用於簽名交易的私鑰

示例：

export ETH_PROVIDER_URL="https://eth-mainnet.g.alchemy.com/v1/your-api-key"
export PRIVATE_KEY="0x123456789abc..."

配置文件

創建一個 config.json 文件並添加以下內容：

{
  "ethereum": {
    "providerUrl": "https://eth-mainnet.g.alchemy.com/v1/your-api-key",
    "apiKey": "your-alchemy-api-key"
  },
  "wallet": {
    "privateKey": "0x123456789abc..."
  }
}

使用示例

基礎用法

完成配置後，您可以通過與 Claude 對話來使用相關功能：

• 創建新錢包：

  您能幫我創建一個新的以太坊錢包嗎？
  

• 查詢餘額：

  0x742d35Cc6634C0532925a3b844Bc454e4438f44e 這個以太坊地址的餘額是多少？
  

• 發送交易：

  您能幫我向 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 發送 0.1 ETH 嗎？
  

Claude 將通過 MCP 服務器直接與以太坊區塊鏈交互。

開發

添加新工具

若要向 MCP 服務器添加新工具，可按以下步驟操作：

1. 在 src/tools.ts 中定義工具
2. 在相應的處理器文件中創建處理器函數
3. 將處理器添加到 src/tools.ts 中的 handlers 對象

構建

npm run build

📄 許可證

本項目採用 MIT 許可證。