eth-mcp-server

eth-mcp-server

ETH に夢中な MCP サーバーです。作成者は、その究極の用途について今も思案しています。今のところ、楽しむためのものです！

MCP について

Model Context Protocol（MCP）を使うと、AI モデルは標準化されたツールやリソースを通じて、リアルタイムのデータにアクセスし、アクションを実行できます。この実装では、MCP フレームワークを通じて、AI アシスタントに Ethereum ブロックチェーンの機能を提供します。

機能

現在、ツールとリソースに対応しています

• 任意の Ethereum アドレスの ETH 残高を取得
• 現在の Ethereum 価格を USD で確認
• Ethereum ネットワークの現在のガス価格を取得
• 最新のブロック情報を取得
• トランザクションの詳細を表示
• トランザクション手数料を見積もり
• アカウントのトランザクション履歴を照会

必要条件

• Python 3.7+
• web3.py
• requests
• mcp.server.fastmcp

セットアップ

1. リポジトリをクローンします
2. 必要な依存関係をインストールします：

   pip install web3 requests
   pip install mcp mcp[cli]
   pip install uv
   

3. コード内の Etherscan API キーを自分のものに置き換えます：

   ETHERSCAN_API_KEY = "YOUR_API_KEY_HERE"
   

利用可能なツール

• get_eth_balance(address) - アドレスの ETH 残高を取得
• get_eth_price() - 現在の Ethereum 価格を USD で取得
• get_gas_price() - 現在の Ethereum ネットワークのガス価格を取得
• get_latest_block() - 最新のブロック情報を取得
• get_transaction(tx_hash) - トランザクションの詳細を取得
• estimate_tx_fee(gas_amount) - トランザクション手数料を見積もり
• get_account_transactions(address, page, offset) - アカウントのトランザクション履歴を取得

利用可能なリソース

• ethereum://price - Ethereum 価格情報
• ethereum://stats - Ethereum ネットワークの統計情報
• ethereum://address/{address} - アドレス情報
• ethereum://address/{address}/transactions - アドレスのトランザクション履歴

API エンドポイント

このサービスでは、以下の外部 API を使用します：

• LlamaRPC 経由の Ethereum JSON-RPC API
• ETH 価格取得用の CoinGecko API
• トランザクション履歴取得用の Etherscan API

cursor でのセットアップ方法

1. cursor の MCP 設定を開きます

2. Add new Global mcp server ボタンをクリックします

3. 以下のように設定し、パスをご自身のパスに置き換えてください

{
  "mcpServers": {
    "eth": {
      "type": "stdio",
      "command": "/path/to/python /path/to/blockchain.py"
    }
  }
}

4. セットアップが完了すると、Cursor のチャットで ETH 情報を取得できます。

例