🚀 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