Aave Liquidation MCP

🚀 Aave清算MCPサーバー

イーサリアムメインネット上のAave V3清算機会を分析するためのモデルコンテキストプロトコル（MCP）サーバーです。このツールにより、ClaudeなどのAIアシスタントがAaveプロトコルデータとやり取りし、ユーザーのポジションを監視し、清算機会を特定することが可能になります。

✨ 主な機能

🔍 ヘルスファクターの監視

• 任意のイーサリアムアドレスに対するリアルタイムのヘルスファクター計算
• 複数の閾値によるリスク検出：
  • 健全（HEALTHY）：ヘルスファクター > 1.05
  • リスクあり（AT_RISK）：1.0 < ヘルスファクター < 1.05
  • 清算可能（LIQUIDATABLE）：ヘルスファクター < 1.0
• 自動的なリスクレベル分類（高、中、低）
• 担保、債務、借入可能額を含むアカウントの概要

💰 清算分析

• 資産別の詳細なポジション内訳
• 清算機会に対する利益推定
• 担保と債務の構成分析
• （資産別の）清算ボーナス計算
• 複数の要素に基づくリスクスコアリング

📊 ポジション追跡

• 任意のアドレスに対する完全なポートフォリオビュー
• 預入と借入の資産別内訳
• 各資産の担保状況
• オンチェーンデータからのリアルタイムの残高更新

🔢 バッチ操作

• 最大20のアドレスを同時にチェック
• 高速な結果を得るための並列処理
• 概要統計情報（清算可能な数、リスクありの数など）
• ポートフォリオ監視のための一括リスク評価

💲 価格とプロトコルデータ

• Aaveオラクルからのリアルタイムの資産価格
• すべてのポジションの米ドル建ての価値
• 完全な設定を含むリザーブ（資産）リスト
• 資産別のLTV、清算閾値、およびボーナス
• データ検証のための現在のブロック番号

このサーバーの特徴

既存の清算ボットが清算を実行するのに対し、このMCPサーバーは以下に焦点を当てています。

• 実行ではなく分析：トランザクションを実行するのではなく、データと洞察を提供します。
• AIファーストな設計：MCPプロトコルを介したAIアシスタントとの統合に最適化されています。
• 教育的価値：ユーザーがDeFi清算の仕組みを理解するのに役立ちます。
• 研究ツール：戦略開発やリスク分析に役立ちます。

📦 インストール

前提条件

• Node.js 18以上
• イーサリアムRPCエンドポイント（Alchemy、Infura、QuickNode、または独自のノード）

セットアップ

1. このリポジトリをクローンまたはダウンロードします。
2. 依存関係をインストールします。

   npm install
   

3. 環境変数を設定します。

   cp .env.example .env
   # .envを編集し、イーサリアムRPC URLを追加します
   

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

   npm run build
   

設定

環境変数

プロジェクトのルートに.envファイルを作成します。

# 必須：イーサリアムRPCエンドポイント
ETHEREUM_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY

# オプション：ヘルスファクターの警告閾値（デフォルト: 1.05）
HEALTH_FACTOR_THRESHOLD=1.05

RPCエンドポイントの取得

以下のサービスから無料のイーサリアムRPCエンドポイントを取得できます。

• Alchemy：https://www.alchemy.com/ （推奨、月に3億のコンピュートユニットが無料）
• Infura：https://www.infura.io/ （1日に10万回のリクエストが無料）
• QuickNode：https://www.quicknode.com/ （無料プランあり）

MCP設定

このサーバーをClaude Desktopの設定ファイルに追加します。 MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aave-liquidation": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/aave-liquidation-mcp/build/index.js"],
      "env": {
        "ETHEREUM_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY"
      }
    }
  }
}

/ABSOLUTE/PATH/TO/を実際のインストールパスに置き換えてください。

💻 使用例

基本的な使用法

サーバーの機能をMCP設定なしでテストするには、以下のコマンドを使用します。

# 現在のETH価格を取得
npm run demo:price

# すべてのAaveリザーブを表示（分類付き）
npm run demo:reserves

# 包括的な接続テストを実行
npm run test:real-data

高度な使用法

Claude Desktopで設定した後、以下のような質問をすることができます。 単一アドレスのクエリ：

• "アドレス0x742d35Cc6634C0532925a3b844Bc454e4438f44eのヘルスファクターを確認してください"
• "このアドレスに清算機会はありますか？"
• "このユーザーの担保ポジションは何ですか？"
• "このアドレスの清算リスクを分析してください：0x..."

バッチ操作：

• "この5つのアドレスの清算リスクを確認してください：[アドレスを貼り付ける]"
• "複数のウォレットを監視し、リスクのあるものを教えてください"
• "これらのアドレス間の清算リスクを比較してください"

プロトコルクエリ：

• "Aave V3で利用可能なすべての資産を表示してください"
• "AaveでのWETHの現在の価格は何ですか？"
• "USDCの清算パラメータは何ですか？"
• "現在のブロック番号は何ですか？"

検証：

• "これは有効なイーサリアムアドレスですか：0x123..."
• "これらのアドレスをチェックする前に検証してください"

セットアップの検証

サーバーをインストールして設定した後、Claude Desktopを再起動し、動作を確認します。 Claudeに質問する：

Aaveプロトコルの状態を確認できますか？

Claudeはget_protocol_statusツールを使用し、以下のような結果を返すはずです。

{
  "protocol": "Aave V3",
  "network": "Ethereum Mainnet",
  "blockNumber": 18500000,
  "poolAddress": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
  "status": "operational"
}

データの理解

ヘルスファクター

• > 1.0：ポジションは健全です。
• < 1.05：ポジションはリスクがあります（警告）。
• < 1.0：ポジションは清算可能です。

リスクレベル

• 高：ヘルスファクター < 1.0（即時清算可能）
• 中：ヘルスファクターが1.0から1.02の間
• 低：ヘルスファクターが1.02から1.05の間

清算ボーナス

ポジションが清算されると、清算者はボーナスを受け取ります（通常、資産によって5 - 10%）。potentialProfitフィールドはこのボーナスを推定します。

開発

プロジェクト構造

aave-liquidation-mcp/
├── src/
│   ├── index.ts           # MCPサーバーの実装
│   ├── aave-client.ts     # Aaveプロトコルとのやり取りロジック
│   ├── constants.ts       # コントラクトアドレスとABI
│   └── types.ts           # TypeScriptの型定義
├── build/                 # コンパイルされたJavaScriptの出力
├── package.json
├── tsconfig.json
└── .env                   # 設定

ビルド

npm run build

開発モード

npm run dev

これにより、ファイルの変更を監視し、自動的に再コンパイルされます。

🔧 技術詳細

Aave V3コントラクト（イーサリアムメインネット）

• プール：0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
• プールデータプロバイダー：0x7B4EB56E7CD4b454BA8ff71E4518426369a138a3
• オラクル：0x54586bE62E3c3580375aE3723C145253060Ca0C2

依存関係

• @modelcontextprotocol/sdk：MCPプロトコルの実装
• ethers：コントラクトとのやり取りのためのイーサリアムライブラリ
• dotenv：環境変数の管理

制限事項

• メインネットのみ：現在はイーサリアムメインネットのみをサポートしています。
• 読み取り専用：清算を実行せず、機会の分析のみを行います。
• レート制限：RPCプロバイダーのレート制限の影響を受けます。
• ガス推定：利益計算は推定値であり、ガスコストを考慮していません。

将来の機能拡張

• [ ] マルチチェーンサポート（Arbitrum、Optimism、Polygon、Base）
• [ ] 過去の清算データと分析
• [ ] ガスコストを含む高度な利益計算
• [ ] リスクのあるポジションに対するWebhook通知
• [ ] 過去のクエリのためのThe Graphとの統合
• [ ] Aave V2とV3の両方のサポート

リソース

• Aave V3ドキュメント
• モデルコンテキストプロトコル
• 清算ガイド

📄 ライセンス

MIT

コントリビューション

コントリビューションは歓迎されます！プルリクエストを送信してください。

免責事項

このツールは教育および研究目的のみで使用されます。DeFiプロトコルでのポジション清算には金融的なリスクが伴います。DeFi活動に参加する前に、必ず独自の調査を行い、リスクを理解してください。