ethereum-tools

Claude MCP 向け Ethereum ツール

モデル コンテキスト プロトコル (MCP) を使用して、Claude AI 内で直接 Ethereum ブロックチェーンを分析するための包括的なツールキット。

特徴

• スマートコントラクト監査: セキュリティ上の問題がないか契約を分析し、ソースコードを検証し、トークン標準を検出します。
• ウォレット分析：ETH残高、トークン保有量、取引履歴を確認する
• 収益性追跡：トークンと取引全体のウォレットの利益/損失を計算します
• ブロックチェーンデータ: シンプルなコマンドでオンチェーンデータを取得して分析
• トークン分析: 包括的なトークンの詳細、価格履歴、取引パターンを取得します

インストール

前提条件

• Node.js v16+
• デスクトップ版クロード
• 無料のAPIキー:
  • Etherscan - 契約の検証と分析
  • Moralis - ウォレットの収益性とトークン残高
  • Codex - トークンの価格履歴と高度な分析
  • (オプション) InfuraのようなRPCプロバイダーまたは無料のパブリックエンドポイントを使用する

セットアップ手順

1. このリポジトリをクローンします:
   git clone https://github.com/giovannialbero1992/ethereum-tools-mcp cd ethereum-tools-mcp
2. 依存関係をインストールします:
   npm install
3. 構成を作成します。
   • mcp.json.exampleをmcp.jsonにコピーします。
   • mcp.jsonを編集して API キーと正しいファイルパスを追加します
   { "mcpServers": { "ethereum-tools": { "command": "node", "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"], "env": { "ETH_RPC_URL": "https://eth.llamarpc.com", "MORALIS_API_KEY": "your_moralis_api_key", "ETHERSCAN_API_KEY": "your_etherscan_api_key", "CODEX_API_KEY": "your_codex_api_key" } } } }
4. Claude をデスクトップ用に設定する:
   • Windowsの場合: %APPDATA%\Claude\claude_desktop_config.jsonを作成/編集します。
   • mcp.jsonファイルの内容をこの構成にコピーします

利用可能なツール

契約分析

• auditContract(address: "0x...") : スマートコントラクトのセキュリティ監査を実行します。

残高とトークン

• getEthBalance(address: "0x...") : ETH残高を取得する
• getTransactionCount(address: "0x...") : トランザクション数を取得する (nonce)
• getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true) : すべてのトークン残高を取得する

収益性

• getWalletPnl(address: "0x...", chain: "eth") : ウォレットの損益を分析する

トークン分析

• getTokenInfo(address: "0x...", networkId: 1) : 名前、シンボル、供給を含む基本的なトークン情報を取得します。
• getTokenPriceHistory(address: "0x...", networkId: 1, days: 7, resolution: "1D") : 過去の価格データを取得する
• analyzeToken(address: "0x...", networkId: 1, days: 30) : ボラティリティや取引パターンを含む包括的なトークン分析を実行します。

ユーティリティ

• add(a: 1, b: 2) : シンプルなユーティリティ関数の例

トラブルシューティング

よくある問題:

• 環境変数が見つかりません: API キーがmcp.jsonに正しく設定されていることを確認してください
• プロバイダーエラー: ETH_RPC_URLが有効でアクセス可能であることを確認してください
• パスエラー: Windows で適切なエスケープを使用した完全な絶対パスを使用していることを確認してください ( \\ )
• Codex API の問題: Codex API キーが有効であり、トークン データにアクセスする権限があることを確認してください

発達

新しいツールを追加するには:

1. tools/ディレクトリ内のファイルを作成または変更する
2. main.jsにツールを登録する
3. 変更を確認するには、Claude for Desktopを再起動してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

謝辞

• Anthropicによるモデルコンテキストプロトコル（MCP）
• Web3.js
• モラリス
• イーサスキャン
• コーデックス