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 用于依赖管理和运行项目。 安装步骤:
- 克隆仓库:git clone https://github.com/kukapay/blocknative-mcp.git 然后 cd blocknative-mcp
- 使用 uv 设置项目:uv sync
- 设置 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 返回为准。