使用说明

项目简介

MCP Ethers Wallet server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为大型语言模型 (LLM) 提供与以太坊区块链进行交互的能力。它通过标准化的 MCP 协议，使得 LLM 能够安全、可控地访问以太坊网络数据、调用智能合约以及管理以太坊钱包。

主要功能点

多网络支持: 支持包括以太坊主网、Polygon、Arbitrum、Optimism、Base 等多种以太坊兼容网络。
区块链数据查询: 提供工具查询区块高度、区块详情、交易详情、Gas 价格和网络费用数据。
钱包操作: 支持检查钱包是否存在、获取钱包余额和交易计数，以及查询 ERC20 代币余额。
交易管理: 支持发送 ETH 交易，并提供高级选项自定义交易参数。
智能合约交互: 支持调用智能合约的只读方法 (view/pure) 和状态变更方法，包括 gas 预估和自定义参数。
ENS 服务: 支持解析 ENS 名称到地址，以及反向查询地址的 ENS 名称。
实用工具: 提供 Wei 和 Ether 单位转换、数值格式化等工具。

安装步骤

确保已安装 Node.js 和 npm。

打开终端，执行以下命令安装 'mcp-ethers-wallet'：

npm install mcp-ethers-wallet

服务器配置

要将 MCP Ethers Wallet server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置服务器的启动命令和参数。以下是配置示例，请根据您的实际安装路径进行调整：

"ethers-wallet": {
  "command": "node",
  "args": [
    "/path-to-mcp-ethers-wallet/build/src/index.js"  // 将 "/path-to-mcp-ethers-wallet" 替换为 mcp-ethers-wallet 的实际安装路径
  ],
  "env": {
    "ALCHEMY_API_KEY": "<<your alchemy api key>>"  //  请替换为您的 Alchemy API 密钥，用于访问以太坊网络
  }
}

配置参数说明:

server name: 'ethers-wallet' (服务器名称，可自定义)
command: 'node' (Node.js 运行命令)
args:
- '/path-to-mcp-ethers-wallet/build/src/index.js': MCP Ethers Wallet server 的入口文件路径。请务必替换为实际路径。
env: 环境变量配置
- 'ALCHEMY_API_KEY': 必填，您的 Alchemy API 密钥，用于连接以太坊网络。您需要在 Alchemy 官网 (alchemy.com) 注册并创建应用以获取 API 密钥。

基本使用方法

启动 MCP 客户端并添加上述配置的 MCP 服务器。
在 MCP 客户端中，您可以使用自然语言指令调用 MCP Ethers Wallet server 提供的工具，例如：
- "Get current block number on Ethereum"
- "What is the balance of address 0xYourAddress on Polygon?"
- "Call contract at 0xContractAddress with ABI [...] and method 'methodName' with arguments [...]"
您可以使用 'getSupportedNetworks' 工具获取支持的网络列表，以便在后续操作中指定网络。

请参考仓库 README.md 文件和工具列表，了解每个工具的详细描述和使用方法。

关键词