Crazyrabbitltc MCP Etherscan Server

🚀 イーサリアムEtherscan MCPサーバー

このサーバーは、Etherscan APIを通じてイーサリアムブロックチェーンのデータを提供するMCP（モデルコンテキストプロトコル）サーバーです。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=あなたのAPIキー

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

npm run build

🚀 クイックスタート

サーバーの起動

npm start

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

📚 ドキュメント

動作原理

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

利用可能なツール

1. check-balance

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

2. get-transactions

   • 入力：イーサリアムアドレス、オプションの制限
   • 出力：タイムスタンプ、価値、アドレスを含む最近の取引

3. get-token-transfers

   • 入力：イーサリアムアドレス、オプションの制限
   • 出力：最近のERC20トークンの転送記録とその詳細情報

4. get-contract-abi

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

5. get-gas-prices

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

6. get-ens-name

   • 入力：イーサリアムアドレス
   • 出力：利用可能な場合は解析されたENS名

Claude Desktopとの連携

このサーバーを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ツールが利用可能になります。

Claudeでの使用例

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

0x742d35Cc6634C0532925a3b844Bc454e4438f44eの残高を確認
または
vitalik.ethの最近の取引記録を表示

🔧 開発

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

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

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。