MCP Crypto Wallet EVM

🚀 MCP 以太坊錢包服務器（EVM）

本項目中的模型上下文協議 (MCP) 服務器，能讓 Claude 藉助 ethers.js v5 對 Ethereum 及 EVM 兼容區塊鏈進行操作。它支持創建錢包、查詢餘額、發送交易以及與智能合約交互等功能。

🚀 快速開始

重啟 Claude Desktop 後，Claude 就能通過 MCP 服務器與以太坊區塊鏈交互。例如：

能否為我創建一個新的以太坊錢包？

0x742d35Cc6634C0532925a3b844Bc454e4438f44e 的餘額是多少？

能否幫助我向 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 發送 0.1 ETH？

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

✨ 主要特性

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/
   

安裝步驟

方案一：使用 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
   

方案二：本地運行

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
}

開發

添加新工具

要添加新的工具到 MCP 服務器：

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

構建

npm run build

📄 許可證

MIT