Web3 Tools MCP

Web3工具MCP服务器

用于区块链交互的模型上下文协议（MCP）服务器 我知道, 以太网扫描，以及 Hypersync.

特性

• 多链支持（以太坊、Arbitrum、雪崩、Base、BNB链、Gnosis、索尼克、乐观主义、多边形、zkSync时代、Linea、单链）
• 🔐 通过浏览器钱包进行交易签名 （MetaMask、Rabby、Coinbase钱包）
• 智能合约交互（读写函数、ABI检索、源代码）
• 合同模拟和天然气估算（模拟交易，估算成本）
• 实时天然气价格跟踪（传统和EIP-1559）
• ENS分辨率（名称↔ 地址、文本记录、头像）
• 代币余额和转账（本地和ERC20，批量查询）
• 使用Hypersync加速的事件日志查询
• 交易追踪和分析
• 带类型解码的存储槽读取

快速开始

克劳德代码

claude mcp add --scope user --transport stdio web3-tools -- npx -y web3-tools-mcp

克劳德桌面

添加到 config.json:

{
  "mcpServers": {
    "web3-tools": {
      "command": "npx",
      "args": ["-y", "web3-tools-mcp"]
    }
  }
}

API密钥（可选）

所有API密钥都是可选的。默认情况下，服务器使用公共RPC。添加钥匙以解锁其他功能：

配置选项：

• --etherscan-api-key 或 ETHERSCAN_API_KEY -启用合约ABI/源检索
• --hypersync-api-key 或 HYPERSYNC_API_KEY -快速事件查询（快10-100倍）
• --alchemy-api-key 或 ALCHEMY_API_KEY -增强RPC可靠性
• --infura-api-key 或 INFURA_API_KEY -其他RPC提供程序
• --custom-rpc -自定义RPC URL为JSON

获取免费的API密钥：

• 以太网扫描： etherscan.io/apis
• Hypersync： Hypersync.xyz
• 炼金术： alchemy.com
• 愤怒 ： 伊芙拉.io

API密钥示例：

# Claude Code
claude mcp add --scope user --transport stdio web3-tools -- npx -y web3-tools-mcp --etherscan-api-key YOUR_KEY --hypersync-api-key YOUR_KEY

# Environment variables
export ETHERSCAN_API_KEY=your_key
export HYPERSYNC_API_KEY=your_key
npx web3-tools-mcp

支持的网络

🔐 浏览器钱包集成

该服务器包括一个内置的钱包接口，用于在不暴露私钥的情况下进行安全的交易签名。

运作原理

1. 当您使用交易工具（例如。， send_native_token)，服务器自动：

- 在上启动本地web服务器 http://localhost:3456 - 打开浏览器连接钱包（MetaMask、Rabby、Coinbase钱包等）

1. 在浏览器中连接钱包一次
2. 交易请求显示在浏览器中以供审批
3. 直接在您的钱包中签署或拒绝交易

支持的钱包

• MetaMask
• 拉比
• Coinbase钱包
• 任何支持EIP-1193的浏览器钱包

手动访问

访问 http://localhost:3456 随时：

• 检查钱包连接状态
• 查看待处理交易
• 查看交易历史记录

注： 当MCP服务器启动时，钱包服务器会自动运行。无需额外设置！

可用工具

签名

• get_function_signature -生成4字节函数选择器
• get_event_signature -生成32字节的事件topic0哈希值
• get_error_signature -生成4字节错误选择器

合同信息

• get_contract_abi -获取具有代理检测和验证状态的ABI
• get_contract_source_code -通过代理支持获取经过验证的源代码
• get_contract_source_file -从缓存中检索特定的源文件
• is_contract -检查地址是合同还是EOA

合约交互

• call_contract_function -调用视图/纯函数（支持批处理）
• call_contract_write -通过浏览器钱包执行状态更改合约功能
• simulate_contract -模拟无广播的合同通话（包括天然气估算）

交易（需要浏览器钱包）

• send_native_token -将ETH/本地代币发送到一个地址
• send_erc20_token -将ERC20代币发送到一个地址
• sign_message -使用您的钱包对消息进行签名
• wallet_status -检查钱包连接状态

气体与模拟

• estimate_gas -估算任何交易的天然气成本
• get_gas_price -获取当前天然气价格（传统和EIP-1559）

ENS

• resolve_ens_name -ENS名称→ 地址
• reverse_resolve_ens -地址→ ENS名称
• get_ens_text_record -获取文本记录（头像、电子邮件、推特等）
• get_ens_avatar -获取头像URI
• batch_resolve_ens_names -批量解析多个名称

余额

• get_balance -获取本地或ERC20余额（支持批量）

事件和日志

• get_logs -使用Hypersync回退查询和解码事件

高级

• get_storage_at -使用类型解码读取存储插槽
• get_block_info -获取块数据（时间戳、哈希等）
• trace_transaction -跟踪执行（调用树、VM、状态差异）

高级配置

自定义RPC

npx web3-tools-mcp --custom-rpc '{"mainnet":"https://my-rpc.com","base":"https://base-rpc.com"}'

RPC故障转移

自动选择提供商：Alchemy→ Infura→ 公共RPC

批量操作

许多工具支持批处理以提高效率（合同调用、余额、ENS分辨率）。

需求

• Node.js≥20.0.0
• RPC调用的互联网连接

测试

npm test              # Run all tests
npm run test:watch   # Watch mode
npm run test:ui      # UI mode

许可证

麻省理工学院