MCP Etherscan サーバー

Etherscan APIを介してEthereumブロックチェーンデータツールを提供するMCP（Model Context Protocol）サーバー。ETH残高の確認、トランザクション履歴の表示、ERC20送金の追跡、コントラクトABIの取得、ガス価格の監視、ENS名の解決などの機能を備えています。

特徴

• 残高確認: 任意のEthereumアドレスのETH残高を取得

• 取引履歴: 最近の取引を詳細情報とともに表示します

• トークン転送: トークンの詳細でERC20トークンの転送を追跡します

• コントラクト ABI : 開発用のスマート コントラクト ABI を取得します。

• ガソリン価格：現在のガソリン価格（安全低価格、標準価格、高速価格）を監視します

• ENS解決: EthereumアドレスをENS名に解決する

Related MCP server: MCP Etherscan Server

前提条件

• Node.js >= 18

• Etherscan API キー ( https://etherscan.io/apisで取得)

インストール

1. リポジトリをクローンします。

git clone [your-repo-url]
cd mcp-etherscan-server

2. 依存関係をインストールします:

npm install

3. ルート ディレクトリに.envファイルを作成します。

ETHERSCAN_API_KEY=your_api_key_here

4. プロジェクトをビルドします。

npm run build

サーバーの実行

サーバーを起動します。

npm start

サーバーは stdio 上で実行されるため、Claude Desktop などの MCP クライアントと互換性があります。

仕組み

このサーバーは、モデルコンテキストプロトコル（MCP）を実装し、EtherscanのAPIを介してEthereumブロックチェーンデータとやり取りするためのツールを提供します。各ツールは、互換性のあるクライアントから呼び出すことができるMCPエンドポイントとして公開されます。

利用可能なツール

1. check-balance

   • 入力: Ethereumアドレス

   • 出力: WeiとETHの両方のETH残高

2. get-transactions

   • 入力: Ethereumアドレス、オプションの制限

   • 出力: タイムスタンプ、値、アドレスを含む最近の取引

3. get-token-transfers

   • 入力: Ethereumアドレス、オプションの制限

   • 出力: 最近のERC20トークン転送とトークンの詳細

4. get-contract-abi

   • 入力: 契約アドレス

   • 出力: JSON形式の契約ABI

5. get-gas-prices

   • 入力: なし

   • 出力: グウェイの現在のガス価格

6. get-ens-name

   • 入力: Ethereumアドレス

   • 出力: 関連するENS名（存在する場合）

Claude Desktopでの使用

このサーバーをClaude Desktopに追加するには:

1. npm startを使用してサーバーを起動します。

2. Claude Desktopの場合:

   • 設定に移動

   • MCPサーバーセクションに移動します

   • 「サーバーを追加」をクリックします

   • 次の構成を入力します。

     {
       "name": "Etherscan Tools",
       "transport": "stdio",
       "command": "node /path/to/mcp-etherscan-server/build/index.js"
     }

   • 設定を保存する

3. EtherscanツールがClaudeとの会話で利用できるようになります

クロードでの使用例

次のようなコマンドを使用できます:

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

または

Show me recent transactions for vitalik.eth

発達

新しい機能を追加したり、既存の機能を変更したりするには:

1. メインのサーバーロジックはsrc/server.tsにあります

2. Etherscan APIのインタラクションはsrc/services/etherscanService.tsで処理されます。

3. 変更後のビルド: npm run build

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照