MCP 加密钱包 EVM

此仓库包含一个模型上下文协议 (MCP) 服务器，该服务器为 Claude 提供通过 ethers.js v5 访问以太坊和 EVM 兼容区块链操作的能力。该服务器使 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 Desktop。现在 Claude 拥有了访问以太坊和 EVM 兼容区块链工具的能力。

示例用法

1. 创建新钱包：

   您能帮我创建一个新的以太坊钱包吗？
   

2. 查询余额：

   0x742d35Cc6634C0532925a3b844Bc454e4438f44e 这个以太坊地址的余额是多少？
   

3. 发送交易：

   您能帮我向 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 发送 0.1 ETH 吗？
   

Claude 将通过 MCP 服务器直接与以太坊区块链交互。

开发

添加新工具

要向 MCP 服务器添加新工具：

1. 在 src/tools.ts 中定义工具
2. 在相应的处理器文件中创建处理器函数
3. 将处理器添加到 src/tools.ts 中的 handlers 对象

构建

npm run build

许可证

MIT