Blocknative MCP Server

Blocknative MCP 服务

一个 MCP 服务，借助 Blocknative 提供多条区块链的实时 Gas 价格预测。

功能

• 工具：
  • predict_gas_price：获取指定链的 Gas 价格预测（默认：Ethereum Mainnet，chain_id=1），包括基础费用，以及包含置信度、价格、最高优先费用和最高费用的表格。
  • estimate_gas_cost：根据 Gas 限制、置信度和链 ID 估算交易成本，并以 Gwei 和 ETH 返回成本。
  • get_supported_chains：以表格形式列出支持的区块链，包括链 ID、系统和网络。
• 提示词：
  • gas_price_query：用于查询特定置信度和链 ID 下 Gas 价格的提示词模板。
• 异步：使用 httpx 向 Blocknative 的 Gas Price 和 Chains API 发送非阻塞 HTTP 请求。
• 可选 API 密钥：无需 Blocknative API 密钥即可低频访问；高频使用则需要设置 BLOCKNATIVE_API_KEY。

先决条件

• Python：版本 3.10
• uv：用于依赖管理和运行项目（安装指南）
• Blocknative API 密钥（可选）：高频访问 API 时需要。请在 Blocknative 注册以获取免费 API 密钥。

安装

1. 克隆代码库：

   git clone https://github.com/kukapay/blocknative-mcp.git
   cd blocknative-mcp
   

2. 使用 uv 设置项目：

   uv sync
   

3. 设置 Blocknative API 密钥（可选）：

   • 如需高频访问，请设置环境变量：

     export BLOCKNATIVE_API_KEY="your-api-key-here"
     

   • 如需低频访问，可跳过此步骤。

使用方法

该服务通过 FastMCP 框架提供三个工具和一个提示词。你可以在开发模式下运行服务、直接执行服务，或将其集成到 Claude Desktop 中。

运行服务

1. 使用 MCP Inspector 运行开发模式：

   uv run mcp dev blocknative-mcp
   

   这会打开 MCP Inspector，这是一个用于交互式测试工具和提示词的 Web 界面。

2. 直接执行：

   uv run blocknative-mcp
   

3. 集成 Claude Desktop：

   uv run mcp install blocknative-mcp --name "Blocknative MCP Server"
   

   这会安装该服务，以便与 Claude Desktop 配合使用。

工具

• predict_gas_price(chain_id: int = 1) -> str： 获取某条链的 Gas 价格预测（默认：Ethereum Mainnet）。返回基础费用以及一个包含置信度、价格、最高优先费用和最高费用的 Markdown 表格。

  • 示例：

    Gas Price Predictions for Chain ID 1 (ethereum/main):
    - Base Fee Per Gas: 0.382910791 Gwei
    
    | Confidence | Price (Gwei) | Max Priority Fee (Gwei) | Max Fee (Gwei) |
    |------------|--------------|-------------------------|----------------|
    | 99%        | 0.52         | 0.14                    | 0.9            |
    | 95%        | 0.48         | 0.094                   | 0.86           |
    | 90%        | 0.47         | 0.089                   | 0.85           |
    | 80%        | 0.46         | 0.079                   | 0.84           |
    | 70%        | 0.45         | 0.069                   | 0.83           |
    

• estimate_gas_cost(gas_limit: int, confidence: int = 99, chain_id: int = 1) -> str： 根据 Gas 限额、置信度和链 ID 估算交易费用。以 Gwei 和 ETH 返回费用。

  • 示例：

    Estimated Gas Cost (Confidence 90%, Chain ID 1):
    - Gas Limit: 21000
    - Max Fee Per Gas: 0.85 Gwei
    - Total Cost: 17850 Gwei (0.00001785 ETH)
    

• get_supported_chains(ctx: Optional[Context] = None) -> str： 以 Markdown 表格列出支持的链，包含链 ID、系统和网络。

  • 示例：

    Supported Chains:
    
    | Chain ID   | System   | Network   |
    |------------|----------|-----------|
    | 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 下 Gas 价格的提示词模板。
  • 示例：

    - User: What is the current gas price for chain ID 1 transactions with 90% confidence?
    - Assistant: Let me fetch the gas price predictions for chain ID 1.
    

许可证

本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。