MCP Crypto Wallet EVM

本仓库包含一个模型上下文协议 (MCP) 服务器，该服务器通过 ethers.js v5 为 Claude 提供对以太坊和 EVM 兼容区块链操作的访问。该服务器使 Claude 能够执行诸如创建钱包、检查余额、发送交易以及与 EVM 兼容区块链上的智能合约交互等操作。

<a href="https://glama.ai/mcp/servers/@dcSpark/mcp-cryptowallet-evm"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@dcSpark/mcp-cryptowallet-evm/badge" alt="Crypto Wallet EVM MCP server" /> </a>

概述

MCP 服务器向 Claude 公开以下工具：

钱包创建和管理

• wallet_create_random: 创建一个具有随机私钥的新钱包
• wallet_from_private_key: 从私钥创建一个钱包
• wallet_from_mnemonic: 从助记词创建一个钱包
• wallet_from_encrypted_json: 通过解密加密的 JSON 钱包来创建一个钱包
• wallet_encrypt: 使用密码加密一个钱包

钱包属性

• wallet_get_address: 获取钱包地址
• wallet_get_public_key: 获取钱包公钥
• wallet_get_private_key: 获取钱包私钥（带有适当的安全警告）
• wallet_get_mnemonic: 获取钱包助记词（如果可用）

区块链方法

• wallet_get_balance: 获取钱包余额
• wallet_get_chain_id: 获取钱包连接到的链 ID
• wallet_get_gas_price: 获取当前 gas 价格
• wallet_get_transaction_count: 获取从此帐户发送的交易数量（nonce）
• wallet_call: 调用合约方法而不发送交易

交易方法

• wallet_send_transaction: 发送交易
• wallet_sign_transaction: 签署交易而不发送它
• wallet_populate_transaction: 使用缺失字段填充交易

签名方法

• wallet_sign_message: 签署消息
• wallet_sign_typed_data: 签署类型化数据 (EIP-712)
• wallet_verify_message: 验证已签名的消息
• wallet_verify_typed_data: 验证已签名的类型化数据

Provider 方法

• provider_get_block: 按编号或哈希获取区块
• provider_get_transaction: 按哈希获取交易
• provider_get_transaction_receipt: 获取交易收据
• provider_get_code: 获取地址处的代码
• provider_get_storage_at: 获取地址的指定位置的存储
• provider_estimate_gas: 估算交易所需的 gas
• provider_get_logs: 获取与过滤器匹配的日志
• provider_get_ens_resolver: 获取名称的 ENS 解析器
• provider_lookup_address: 查找地址的 ENS 名称
• provider_resolve_name: 将 ENS 名称解析为地址

网络方法

• network_get_network: 获取当前网络信息
• network_get_block_number: 获取当前区块号
• network_get_fee_data: 获取当前费用数据（基础费用、最高优先级费用等）

前提条件

• Node.js (v16 或更高版本)
• Claude Desktop 应用程序

安装

选项 1：使用 npx (推荐)

您可以使用 npx 直接运行 MCP 服务器，无需安装：

npx @mcp-dockmaster/mcp-cryptowallet-evm

这将直接从 npm 下载并执行服务器。

选项 2：手动安装

1. 克隆此仓库：

   git clone https://github.com/dcSpark/mcp-cryptowallet-evm.git
   cd mcp-cryptowallet-evm
   

2. 安装依赖项：

   npm ci
   

3. 构建项目：

   npm run build
   

配置

环境变量

MCP 服务器支持以下环境变量：

• PRIVATE_KEY: 可选的私钥，用于在未显式提供钱包时进行钱包操作

配置 Claude Desktop

要配置 Claude Desktop 以使用此 MCP 服务器：

1. 打开 Claude Desktop

2. 导航到 Claude Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

3. 添加 MCP 服务器配置：

{
  "mcpServers": {
    "mcp-cryptowallet-evm": {
      "command": "npx",
      "args": [
        "@mcp-dockmaster/mcp-cryptowallet-evm"
      ]
    }
  }
}

或者，如果您在本地安装了该软件包：

{
  "mcpServers": {
    "mcp-cryptowallet-evm": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-cryptowallet-evm/build/index.js"
      ]
    }
  }
}

本地运行

node build/index.js

用法

配置完成后，重新启动 Claude Desktop。 Claude 现在将可以访问以太坊和 EVM 兼容的区块链工具。 您可以要求 Claude：

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