SuperAPI AI 工具集

blocknative-mcp

Blocknative MCP Server 是一个基于 MCP(Model Context Protocol)的服务器,通过 Blocknative 的 Gas Price 与 Chains API 提供多条区块链的实时 Gas 价格预测。它提供三个工具:predict_gas_price 获取指定链的 Gas 价格预测(含基础费及不同置信度下的价格、最大优先费、最大费),estimate_gas_cost 根据 Gas 限额、置信度和链 ID 估算交易成本(以 Gwei 和 ETH 返回),get_supported_chains 列出支持的区块链(链 ID、系统、网络)。另提供一个提示模板 gas_price_query,用于按指定置信度和链 ID 查询 Gas 价格。项目使用 httpx 进行异步非阻塞 HTTP 请求,支持可选 API Key:低频访问无需 Blocknative API Key,高频使用需设置 BLOCKNATIVE_API_KEY 环境变量。运行环境要求 Python 3.10 及 uv 依赖管理工具。可通过 MCP Inspector 开发模式、直接执行或集成到 Claude Desktop 使用。

访问官网

工具介绍

Blocknative MCP Server 是一个 MCP(Model Context Protocol)服务器,用于提供多条区块链的实时 Gas 价格预测,底层由 Blocknative 的 Gas Price 与 Chains API 驱动。

用途:为需要查询或估算区块链交易 Gas 成本的场景提供工具化接口,支持通过 MCP 框架被 AI 助手或开发工具调用。

主要能力:

  • predict_gas_price:获取指定链(默认以太坊主网,chain_id=1)的 Gas 价格预测,返回基础费(Base Fee Per Gas)以及一个包含置信度、价格、最大优先费、最大费的 Markdown 表格。
  • estimate_gas_cost:根据 Gas 限额、置信度(默认 99)和链 ID(默认 1)估算交易成本,以 Gwei 和 ETH 返回。
  • get_supported_chains:以 Markdown 表格列出支持的区块链,包含链 ID、系统、网络。
  • gas_price_query:一个提示模板,用于按指定置信度和链 ID 查询 Gas 价格。

技术特性:使用 httpx 进行异步非阻塞 HTTP 请求;支持可选 API Key——低频访问无需 Blocknative API Key,高频使用需设置 BLOCKNATIVE_API_KEY 环境变量。

使用方式: 环境要求:Python 3.10;uv 用于依赖管理和运行项目。 安装步骤:

  1. 克隆仓库:git clone https://github.com/kukapay/blocknative-mcp.git 然后 cd blocknative-mcp
  2. 使用 uv 设置项目:uv sync
  3. 设置 Blocknative API Key(可选):高频访问需设置环境变量 export BLOCKNATIVE_API_KEY="your-api-key-here";低频访问可跳过此步。

运行服务器:

  • 开发模式(MCP Inspector):uv run mcp dev blocknative-mcp,打开 MCP Inspector 网页界面交互测试工具和提示。
  • 直接执行:uv run blocknative-mcp
  • 集成 Claude Desktop:uv run mcp install blocknative-mcp --name "Blocknative MCP Server"

工具示例: predict_gas_price(chain_id: int = 1) -> str:返回基础费及置信度表格,例如链 ID 1 的预测中,99% 置信度下价格为 0.52 Gwei、最大优先费 0.14 Gwei、最大费 0.9 Gwei。 estimate_gas_cost(gas_limit: int, confidence: int = 99, chain_id: int = 1) -> str:例如 Gas 限额 21000、置信度 90%、链 ID 1 时,最大费每 Gas 0.85 Gwei,总成本 17850 Gwei(0.00001785 ETH)。 get_supported_chains(ctx: Optional[Context] = None) -> str:例如列出链 ID 1(ethereum/main)、137(polygon/mainnet)、8453(base/mainnet)、11155111(ethereum/sepolia)。 gas_price_query(confidence: int, chain_id: int = 1) -> List[base.Message]:提示模板,例如用户询问“链 ID 1 交易在 90% 置信度下的当前 Gas 价格是多少?”

适用场景:需要实时 Gas 价格预测或交易成本估算的区块链开发、交易辅助、AI 助手集成等场景。

限制:项目采用 MIT 许可证;高频 API 访问需要 Blocknative API Key;具体支持的链列表以 get_supported_chains 返回为准。