base-gas-mcp

base-gas-mcp

x402](https://www.x402.org) 決済プロトコルを通じて、呼び出しごとに USDC で支払う、Base のリアルタイムのガスデータを提供する MCP サーバーです。API キーもアカウントも不要です。エージェントは、管理下にあるウォレットから 1 セント未満の金額を支払います。

RPC 呼び出しでは答えられない質問に答えます。トランザクションのドル建てコスト、現在最も安いチェーン、ガス代が高いか低いか、避けるべき時間帯がわかります。

ツール

ツール	価格	返される内容
get_base_gas	~$0.002	Base のベースフィー、低・中・高の優先手数料、トランザクションの USD、ETH、gwei 建てのコスト、および署名可能な maxFeePerGas / maxPriorityFeePerGas（wei）を返します。gasLimit は任意です。
compare_gas_costs	~$0.01	Base、OP Mainnet、Arbitrum One、Ethereum における同じトランザクションのコストを USD 建てで、安い順に返します。gasLimit は任意です。
get_gas_history	~$0.01	過去の hours 時間（デフォルトは 24 時間）の Base のガスデータを返します。最小値、最大値、平均値、中央値、および現在のガス代が安い、通常、高い、横ばいのいずれかを示します。
get_cheapest_window	~$0.02	過去 7 日間のデータから、避けるべき時間帯、最も安い時間（UTC）、節約額を割合と USD で返します。
get_service_status	無料	サービスが稼働中かどうかと、収集済みの履歴量を返します。ウォレットは不要です。

価格はエンドポイントで設定され、 OpenAPI ドキュメントで公開されています。 支払いが必要な各結果には、決済トランザクションのハッシュが含まれます。

gasLimit の目安：ETH 送金は 21000（デフォルト）、ERC-20 送金は約 65000、NFT のミントは約 85000、Uniswap のスワップは約 180000、コントラクトのデプロイは約 1500000 です。

安全性

• サーバーが支払うのは、あなたが設定した単一のオリジンだけです（デフォルトは稼働中の base-gas-x402 API）。URL を受け取るツールはないため、モデルが読み取ったテキストによってウォレットの支払い先が別の有料エンドポイントに変更されることはありません。
• 支払い上限。 MAX_USD_PER_CALL（デフォルトは 0.05）を超える支払いは、署名される前に拒否されます。
• 支払いには EIP-3009 の認可を使用します。ウォレットに必要なのはUSDC だけで、ETH は不要です。
• 数ドルを保有する別のウォレットを使用してください。支払いへの署名に使うキーは環境変数から読み取られ、ログに記録されたり返されたりすることはありません。

有料データソースは、関連プロジェクトです。 base-gas-x402。

インストール

要件

• Node.js 18 以降（組み込みの fetch が必要です）
• 少額の USDC を保有する Base メインネットのウォレット（ETH は不要です）

git clone https://github.com/memosr/base-gas-mcp.git
cd base-gas-mcp
npm install

BUYER_PRIVATE_KEY は MCP クライアントの設定を通じて渡してください（下記を参照）。サーバーは .env ファイルを読み取りません。

または、公開済みパッケージを npx base-gas-mcp で直接実行します（下記の設定ブロックを参照）。

購入者キーの取得

BUYER_PRIVATE_KEY は、Base メインネットのウォレットの秘密鍵です。新しいウォレットを作成し（MetaMask、Coinbase Wallet、または cast wallet new など）、秘密鍵をエクスポートして、Base 上で数ドル分の USDC を入金してください。

**警告：**これは、実際の資金を管理する本物の秘密鍵です。 少額のみを保有する、使い捨ての別ウォレットを使用してください。多額の資金があるウォレットのキーを使い回したり、git にコミットしたり、チャットに貼り付けたりしないでください。サーバーは支払いへの署名にのみ使用し、ログに記録したり返したりすることはありません。

環境変数

変数	必須	説明
BUYER_PRIVATE_KEY	はい	資金が入った Base メインネットのウォレットの 32 バイトの 16 進数秘密鍵（16 進数 64 文字。0x 接頭辞は省略可能）です。
MAX_USD_PER_CALL	いいえ	1 回の支払いがこの USD 額を超える場合に拒否します。デフォルトは 0.05 です。
BASE_GAS_ORIGIN	いいえ	サーバーが支払いを行う唯一のオリジンです。デフォルトは https://base-gas-x402-production.up.railway.app です。
BUILDER_CODE	いいえ	アトリビューション用に支払いペイロードへ付加する Base Builder Code です。デフォルトは bc_lhfd8zad です。

設定

Claude Desktop

claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json、Windows：%APPDATA%\Claude\claude_desktop_config.json）に追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "base-gas": {
      "command": "npx",
      "args": ["-y", "base-gas-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_MAINNET_PRIVATE_KEY"
      }
    }
  }
}

ローカルのクローンから実行する場合は、command に Node を指定し、サーバーへの絶対パスを使用します。

{
  "mcpServers": {
    "base-gas": {
      "command": "node",
      "args": ["/absolute/path/to/base-gas-mcp/src/server.js"],
      "env": {
        "BUYER_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_MAINNET_PRIVATE_KEY"
      }
    }
  }
}

Claude Code

claude mcp add base-gas \
  --env BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_MAINNET_PRIVATE_KEY \
  -- npx -y base-gas-mcp

ローカルのクローンから実行する場合：

claude mcp add base-gas \
  --env BUYER_PRIVATE_KEY=0xYOUR_FUNDED_BASE_MAINNET_PRIVATE_KEY \
  -- node /absolute/path/to/base-gas-mcp/src/server.js

サーバーは、クライアントから渡された環境変数のみを設定として読み込みます。.env ファイルは読み込まれないため（0.3.1 以降）、クライアントが開いたフォルダーに .env があっても、ウォレットの支払い先は変更されません。

使用例

設定後、エージェントに次のように尋ねてください。

• 「今、Base で Uniswap のスワップをすると、ドルでいくらかかりますか？」（gasLimit 180000 を指定した get_base_gas）
• 「現時点では、トークンの送金は Base と Arbitrum のどちらが安いですか？」（compare_gas_costs）
• 「今は Base のガス代が高いですか？ それとも待ったほうがよいですか？」（get_gas_history）
• 「Base でトランザクションをまとめて実行する場合、いつスケジュールすればよいですか？」（get_cheapest_window）

いずれも有料の呼び出しです。まず無料の get_service_status で確認してください。

技術スタック

• Node.js（ESM）、stdio トランスポート経由で提供
• MCP サーバー向けの @modelcontextprotocol/sdk
• 決済付き fetch、EIP-3009 の正確な決済方式、ビルダーコードのアトリビューション向けの @x402/fetch、@x402/evm、@x402/extensions
• アカウントの処理と署名向けの viem
• 入力の検証向けの zod

ライセンス

MIT、著作権 (c) 2026 memosr。