Blocknative MCP Server

Blocknative MCP サーバー

Blocknative を活用し、複数のブロックチェーンにおけるガス価格をリアルタイムで予測する MCP サーバーです。

特徴

• ツール：
  • predict_gas_price：指定したチェーン（デフォルト：Ethereum Mainnet、chain_id=1）のガス価格予測を取得します。ベースフィーに加え、信頼度レベル、価格、最大優先手数料、最大手数料を含む表を返します。
  • estimate_gas_cost：ガスリミット、信頼度レベル、チェーン ID に基づいてトランザクションコストを推定し、Gwei と ETH で返します。
  • get_supported_chains：対応するブロックチェーンを、チェーン ID、システム、ネットワークを含む表で一覧表示します。
• プロンプト：
  • gas_price_query：特定の信頼度レベルとチェーン ID のガス価格を問い合わせるためのプロンプトテンプレートです。
• 非同期：httpx を使用し、Blocknative の Gas Price API と Chains API への HTTP リクエストを非ブロッキングで実行します。
• API キーは任意：Blocknative API キーなしで低頻度のアクセスが可能です。高頻度での利用には BLOCKNATIVE_API_KEY の設定が必要です。

前提条件

• Python：バージョン 3.10
• uv：依存関係の管理とプロジェクトの実行に使用します（インストールガイド）
• Blocknative API キー（任意）：高頻度での API アクセスに必要です。無料の API キーを取得するには、Blocknative に登録してください。

インストール

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 フレームワーク経由で利用できる 3 つのツールと 1 つのプロンプトを提供します。開発モードでサーバーを実行するか、直接実行するか、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： チェーンのガス価格予測を取得します（デフォルト：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： ガス上限、信頼度、チェーン 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： 対応チェーンを、チェーン ID、システム、ネットワークを含む Markdown テーブルで一覧表示します。

  • 例：

    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 でガス価格を問い合わせるためのプロンプトテンプレートです。
  • 例：

    - 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 ファイルをご覧ください。