NodeFlare

NodeFlare MCP Server

为 AI Agent 提供 23 条 EVM 链的区块链 JSON-RPC 服务，包括 Ethereum、Base、BNB Chain、Arbitrum、Optimism、Avalanche、HyperEVM、Polygon，以及 Robinhood Chain、Plasma、Ink、Zircuit、BOB 和 Soneium 等新兴链。服务由 NodeFlare 在 5 个区域部署的自有裸金属节点提供。

快速开始

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

就是这么简单——标准读取操作（区块号、余额、交易、eth_call）无需 API 密钥。

每个工具的 chain 参数都接受 slug（eth、base、arb）、名称（ethereum、arbitrum、bsc）或 数字链 ID（1、8453），因此 Agent 无需了解 NodeFlare 的内部 slug。

安装为 Claude Code 插件

此仓库同时也是一个 Claude Code 插件市场。安装插件后，只需一步即可配置 MCP 服务 以及 一组斜杠命令配方：

claude plugin marketplace add Nodeflare-app/nodeflare-mcp
claude plugin install nodeflare

然后使用下方的配方（/nodeflare:balance、/nodeflare:token 等）。若要启用高负载方法，请在启动 Claude Code 前，于 shell 中导出 NODEFLARE_API_KEY（免费密钥，每月 2M CU）。

配方

插件内置的现成斜杠命令：

配方	功能
/nodeflare:chains [filter]	列出受支持的链、ID 和端点 URL
/nodeflare:balance <address> [chain] [token…]	原生资产和 ERC-20 余额，可查询单条链或主要链
/nodeflare:token <token> [chain] [holder]	ERC-20 元数据（名称／符号／小数位数／供应量）+ 可选的持有者余额
/nodeflare:tx <hash> [chain]	获取交易和回执，并说明其执行内容
/nodeflare:logs <contract> [chain] [from] [to]	获取并汇总合约近期的事件日志
/nodeflare:gas [chain | compare]	查询某条链的当前 Gas 价格，或按价格从低到高进行比较

访问层级

服务会根据环境变量选择访问层级：

环境变量	层级
(无)	免费公共端点——标准读取方法，按 IP 限速
NODEFLARE_API_KEY	免费／付费密钥——高负载方法，每月免费提供 2,000,000 个计算单位（获取密钥）
X402_PRIVATE_KEY	通过 x402 按次付费——高负载方法（eth_getLogs、trace_*、debug_*）通过此钱包，以 Base、Polygon 或 Arbitrum 上的 USDC 支付，约 $0.001／次。无需账户；Gas 由支付促进方承担。

使用 x402 钱包时，被阻止的高负载方法会自动重试为付费调用——如果付款已在链上结算，工具结果将包含 "_x402": "settled via x402"。

{
  "mcpServers": {
    "nodeflare": {
      "command": "npx",
      "args": ["-y", "nodeflare-mcp"],
      "env": { "X402_PRIVATE_KEY": "0x…" }
    }
  }
}

请使用持有少量 USDC 的专用 Agent 钱包，切勿使用主钱包。

工具

工具	描述
list_chains	23 条受支持的链及其链 ID 和端点
get_block_number	最新区块编号（十进制 + 十六进制）
get_balance	原生代币余额——原始 wei 值 + 链上货币的易读金额
get_transaction_receipt	根据哈希查询交易收据
eth_call	只读合约调用
get_logs	合约事件日志（开销较大——需要密钥或 x402 钱包）
rpc_call	在任意受支持的链上调用任意 JSON-RPC 方法
get_transaction	根据哈希查询交易（from、to、value、input）
get_block	根据编号或标签查询区块，可选返回完整交易
get_gas_price	当前 Gas 价格 + EIP-1559 优先费
get_token_balance	ERC-20 余额，原始值 + 易读金额
get_token_metadata	ERC-20 名称、符号、小数位数、总供应量
resolve_ens	ENS 名称 → 地址（正向解析），或地址 → 主 ENS 名称（反向解析）
get_token_price	ERC-20 当前 USD 价格（DefiLlama，无需密钥）——价格、符号、置信度
compare_gas	一次调用即可比较各链的 Gas 价格，并按从低到高排列，让 Agent 选择交易链
get_multichain_balances	一次调用即可查询一个地址在 23 条链中的多条链上的原生代币 + ERC-20 余额（包括新链）；按次付费，需使用 x402 钱包
get_token_allowances	查询钱包在各链授予的 ERC-20 授权，排除已撤销的授权并标记无限授权（开销较大——需要密钥或 x402）
get_wallet_report	完整的“了解此钱包”报告：各链上的余额 + USD 总额 + 主要持仓 + 有效授权（授权部分开销较大）
check_token_safety	交易前检查 ERC-20 风险：所有权、代理检测、持有人集中度、蜜罐模拟 → 风险评分（深度检查开销较大）
simulate_transaction	交易预检：是否会回滚、使用的 Gas，以及哪些代币/ETH 会发生变动（资产变更追踪开销较大）
onchain_answer	链上答案引擎——用通俗语言询问钱包/代币，单次调用即可获得附有引用的结论（需要密钥或 x402；无免费套餐）

地址参数（get_balance、get_token_balance、eth_call）也接受 ENS 名称——传入 vitalik.eth，系统会自动将其解析为地址。

get_multichain_balances 还可以自动发现地址持有的代币（discover: true，需要 x402 钱包）。发现的代币会通过 DefiLlama 获取 USD 价格，并在支持价格数据的链上按价值筛选：传入 minUsd（默认 0.01）设置无价值代币的过滤门槛，传入 includeSpam: true 保留未定价的代币，或传入 includeDust: true 保留低于 1e-9 的余额。

提示词（任意 MCP 客户端）

该服务还会将操作指南作为 MCP 提示词公开，因此任何 MCP 客户端（Cursor、Windsurf，等等）都能显示引导式工作流，而不仅限于 Claude Code 插件：chains、balance、token、tx、logs、gas。

链接

• NodeFlare — 免费 API 密钥，每月 2M CU
• x402 按次请求付费 — 定价及工作原理
• 文档 · 状态 · Discord

MIT