MCP Etherscan Server

🚀 MCP イーサリアムブラウザサーバ

Model Context Protocol (MCP) サーバで、Etherscan の API を通じてイーサリアムブロックチェーンのデータツールを提供します。機能には、ETH 残高の確認、取引履歴の閲覧、ERC20 トークンの転送追跡、スマートコントラクトの ABI 取得、ガス価格の監視、ENS 名の解決などが含まれます。

✨ 主な機能

• 残高確認：任意のイーサリアムアドレスの ETH 残高を照会します。
• 取引記録：最近の取引とその詳細情報を閲覧します。
• トークン転送：ERC20 トークンの転送とトークンの詳細を追跡します。
• コントラクト ABI：開発用にスマートコントラクトの ABI を取得します。
• ガス価格：現在のガス価格（安全低、標準、高速）を監視します。
• ENS 解決：イーサリアムアドレスを ENS 名に解決します。

📦 インストール

前提条件

• 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

サーバは標準入出力で動作し、MCP クライアント（Claude Desktop など）と互換性があります。

🔧 技術詳細

このサーバは Model Context Protocol (MCP) を実装し、Etherscan の API を通じてイーサリアムブロックチェーンのデータツールを提供します。各ツールは MCP エンドポイントとして公開され、互換性のあるクライアントから呼び出すことができます。

利用可能なツール

1. check-balance

   • 入力：イーサリアムアドレス
   • 出力：ETH 残高（Wei と ETH 単位）

2. get-transactions

   • 入力：イーサリアムアドレス、任意の制限数
   • 出力：最近の取引記録（タイムスタンプ、価値、アドレスを含む）

3. get-token-transfers

   • 入力：イーサリアムアドレス、任意の制限数
   • 出力：最近の ERC20 トークン転送とトークンの詳細

4. get-contract-abi

   • 入力：コントラクトアドレス
   • 出力：コントラクト ABI の JSON 形式

5. get-gas-prices

   • 入力：なし
   • 出力：現在のガス価格（Gwei 単位）

6. get-ens-name

   • 入力：イーサリアムアドレス
   • 出力：関連付けられた ENS 名（ある場合）

💻 使用例

基本的な使用法

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

0x742d35Cc6634C0532925a3b844Bc454e4438f44e の残高を確認

または

vitalik.eth の最近の取引記録を表示

高度な使用法

Claude Desktop へのサーバの追加手順：

1. npm start でサーバを起動します。

2. Claude Desktop で：

   • 設定に移動します。
   • MCP サーバの部分を選択します。
   • 「サーバを追加」をクリックします。
   • 以下の設定を入力します：

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

   • 設定を保存します。

3. これで、Claude の会話で Etherscan ツールが使用可能になります。

開発

新機能の追加や既存機能の修正：

1. メインサーバのロジックは src/server.ts にあります。
2. Etherscan API のやり取りは src/services/etherscanService.ts で処理されます。
3. 変更後、ビルドを行います：

   npm run build
   

📄 ライセンス

[ここにライセンス情報（MIT や GPL など）を追加]

この MCP イーサリアムブラウザサーバを使用することで、開発者、研究者、ブロックチェーン愛好家がイーサリアムブロックチェーンのデータを簡単に統合および管理できます。