article
README
🚀 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
合约交互
合约部署:在区块链上部署新智能合约合约调用:与已部署的智能合约进行交互交易状态查询:检查交易的状态和详细信息
📦 安装指南
先决条件
- 安装 Node.js 和 npm:
https://nodejs.org/ - 安装 ethers.js:
npm install ethers - 下载 MetaMask 并安装:
https://metamask.io/
安装步骤
方案一:使用 npm 包
- 克隆仓库:
git clone https://github.com/dcSpark/mcp-cryptowallet-evm.git - 进入目录:
cd mcp-cryptowallet-evm - 安装依赖并构建:
npm install npm run build - 启动服务器:
node build/index.js
方案二:本地运行
- 克隆仓库后直接运行:
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 服务器:
- 在
src/tools.ts中定义工具 - 创建对应的处理函数
- 将处理器添加到
handlers对象中
构建
npm run build
📄 许可证
MIT
扫码联系在线客服