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活动之前，请务必自行进行研究并了解相关风险。