MCP Crypto Wallet EVM

MCP 加密钱包 EVM

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

概述

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_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桌面应用程序

安装

选项 1：使用 npx（推荐）

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

这将直接从 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 桌面

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

1. 打开 Claude 桌面
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 服务器配置：

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

本地运行

用法

配置完成后，重新启动 Claude Desktop。Claude 现在就可以访问以太坊和 EVM 兼容的区块链工具了。您可以让 Claude 执行以下操作：

1. 创建新钱包：
   Can you create a new Ethereum wallet for me?
2. 检查钱包余额：
   What's the balance of the Ethereum wallet address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?
3. 发送交易：
   Can you help me send 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?

Claude 将使用 MCP 服务器直接与以太坊区块链进行交互。

发展

添加新工具

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

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

建筑

执照

麻省理工学院