Aave Liquidation MCP

🚀 Aave清算MCP服務器

這是一個模型上下文協議（MCP）服務器，用於分析以太坊主網上Aave V3的清算機會。該工具能讓Claude等AI助手與Aave協議數據進行交互，監控用戶頭寸，並識別清算機會。

🚀 快速開始

在Claude桌面端配置完成後，你可以提出如下問題：

• 單地址查詢：
  • “檢查地址0x742d35Cc6634C0532925a3b844Bc454e4438f44e的健康因子”
  • “這個地址有清算機會嗎？”
  • “這個用戶的抵押頭寸有哪些？”
  • “分析這個地址0x...的清算風險”
• 批量操作：
  • “檢查這5個地址的清算風險：[粘貼地址]”
  • “監控多個錢包，告訴我哪些有風險”
  • “比較這些地址的清算風險”
• 協議查詢：
  • “展示Aave V3中所有可用資產”
  • “Aave中WETH的當前價格是多少？”
  • “USDC的清算參數是什麼？”
  • “當前區塊號是多少？”
• 驗證：
  • “0x123...是有效的以太坊地址嗎？”
  • “在檢查這些地址之前先驗證一下”

服務器安裝和配置完成後，重啟Claude桌面端並驗證其是否正常工作： 向Claude提問：

你能檢查Aave協議的狀態嗎？

Claude將使用get_protocol_status工具，並應返回類似如下內容：

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

✨ 主要特性

🔍 健康因子監控

• 為任意以太坊地址進行即時健康因子計算
• 多閾值風險檢測：
  • 健康（HEALTHY）：健康因子 > 1.05
  • 有風險（AT_RISK）：1.0 < 健康因子 < 1.05
  • 可清算（LIQUIDATABLE）：健康因子 < 1.0
• 自動風險等級分類（高、中、低）
• 包含抵押品、債務和借款能力的賬戶摘要

💰 清算分析

• 按資產進行詳細的頭寸細分
• 對清算機會進行利潤估算
• 抵押品和債務構成分析
• 清算獎勵計算（特定資產）
• 基於多因素的風險評分

📊 頭寸跟蹤

• 為任意地址提供完整的投資組合視圖
• 按資產細分存款和借款情況
• 每種資產的抵押品狀態
• 從鏈上數據進行即時餘額更新

🔢 批量操作

• 同時檢查最多20個地址
• 並行處理以獲得更快的結果
• 彙總統計信息（可清算數量、有風險數量等）
• 用於投資組合監控的批量風險評估

💲 價格與協議數據

• 從Aave預言機獲取即時資產價格
• 所有頭寸以美元計價
• 列出儲備資產及其完整配置
• 按資產列出貸款價值比（LTV）、清算閾值和獎勵
• 當前區塊號用於數據驗證

📦 安裝指南

前提條件

• Node.js 18或更高版本
• 以太坊RPC端點（Alchemy、Infura、QuickNode或你自己的節點）

安裝步驟

1. 克隆或下載此倉庫
2. 安裝依賴項：

npm install

3. 配置環境變量：

cp .env.example .env
# 編輯.env文件並添加你的以太坊RPC URL

4. 構建項目：

npm run build

💻 使用示例

基礎用法

# 獲取當前ETH價格
npm run demo:price

# 查看所有Aave儲備資產（分類顯示）
npm run demo:reserves

# 運行全面的連接測試
npm run test:real-data

高級用法

以下是可用工具的使用示例：

1. get_user_health

獲取特定地址的健康因子和賬戶數據。 輸入：

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

輸出：

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "healthFactor": "1.234",
  "totalCollateralUSD": "150000.00",
  "totalDebtUSD": "100000.00",
  "availableBorrowsUSD": "20000.00",
  "liquidationThreshold": "0.85",
  "ltv": "0.80",
  "isLiquidatable": false,
  "isAtRisk": false,
  "status": "HEALTHY"
}

2. analyze_liquidation

分析某個頭寸的清算機會並提供詳細細分。 輸入：

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

輸出：

{
  "userAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "healthFactor": "0.98",
  "totalCollateralUSD": "150000.00",
  "totalDebtUSD": "140000.00",
  "riskLevel": "HIGH",
  "potentialProfit": "7000.00",
  "collateralAssets": [...],
  "debtAssets": [...]
}

3. get_user_positions

獲取某個地址的詳細抵押和債務頭寸。 輸入：

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

4. get_aave_reserves

獲取所有可用的Aave V3儲備資產及其配置列表。 輸入：無需輸入 輸出：包含貸款價值比、清算閾值、清算獎勵等信息的所有儲備資產列表。

5. get_asset_price

從Aave預言機獲取特定資產的當前美元價格。 輸入：

{
  "assetAddress": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
}

6. get_protocol_status

獲取Aave V3協議狀態和當前區塊號。 輸入：無需輸入

7. batch_check_addresses

一次性檢查多個地址的清算機會（每次請求最多20個地址）。 輸入：

{
  "addresses": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "0xAnotherAddress...",
    "0xYetAnotherAddress..."
  ]
}

輸出：

{
  "totalChecked": 3,
  "liquidatable": 1,
  "atRisk": 1,
  "healthy": 1,
  "results": [...]
}

8. validate_address

驗證一個字符串是否為格式正確的以太坊地址。 輸入：

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

輸出：

{
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "isValid": true,
  "message": "Valid Ethereum address format"
}

📚 詳細文檔

配置

環境變量

在項目根目錄下創建一個.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/ （每天10萬個請求免費）
• QuickNode：https://www.quicknode.com/ （有免費套餐）

MCP配置

將此服務器添加到你的Claude桌面端配置文件中：

• 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/替換為你實際的安裝路徑。

數據理解

健康因子

• > 1.0：頭寸健康
• < 1.05：頭寸有風險（警告）
• < 1.0：頭寸可被清算

風險等級

• 高（HIGH）：健康因子 < 1.0（可立即清算）
• 中（MEDIUM）：健康因子介於1.0和1.02之間
• 低（LOW）：健康因子介於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合約（以太坊主網）

• 資金池（Pool）：0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2
• 資金池數據提供者（Pool Data Provider）：0x7B4EB56E7CD4b454BA8ff71E4518426369a138a3
• 預言機（Oracle）：0x54586bE62E3c3580375aE3723C145253060Ca0C2

依賴項

• @modelcontextprotocol/sdk：MCP協議實現
• ethers：用於合約交互的以太坊庫
• dotenv：環境變量管理

侷限性

• 僅支持主網：目前僅支持以太坊主網
• 只讀：不執行清算操作，僅分析清算機會
• 速率限制：受你的RPC提供商的速率限制影響
• 燃氣費估算：利潤計算為估算值，未考慮燃氣成本

未來改進

• [ ] 多鏈支持（Arbitrum、Optimism、Polygon、Base）
• [ ] 歷史清算數據和分析
• [ ] 包括燃氣成本的高級利潤計算
• [ ] 針對有風險頭寸的Webhook通知
• [ ] 與The Graph集成以進行歷史查詢
• [ ] 同時支持Aave V2和V3

資源

• Aave V3文檔
• 模型上下文協議
• 清算指南

📄 許可證

本項目採用MIT許可證。

貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

免責聲明

本工具僅用於教育和研究目的。在DeFi協議上清算頭寸涉及金融風險。在參與DeFi活動之前，請務必自行進行研究並瞭解相關風險。