🚀 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 许可证。