graph-aave-mcp

npm version MCP Registry License: MIT

用于 AAVE V2、V3 和 V4 的 MCP 服务器 —— 涵盖 16 个 Graph 子图 + Aave V4 API 的 40 个工具。

涵盖借贷市场、用户头寸、健康因子、跨链清算风险监控、清算、闪电贷、治理、V4 中心/分支 (Hubs/Spokes)、汇率、兑换报价、奖励和协议历史。

已发布至 MCP Registry，标识符为 io.github.PaulieB14/graph-aave-mcp

三种数据源

数据源	版本	提供内容	认证
The Graph 子图	V2/V3	7 条链上的 11 个子图 — 储备金、头寸、事件、治理	`GRAPH_API_KEY` (免费)
清算风险子图	V3	5 条链 — 实时健康因子、风险评分、风险警报、协议风险统计	`GRAPH_API_KEY` (免费)
Aave V4 API	V4	中心、分支、储备金、汇率、用户头寸、活动、兑换报价、奖励	无需认证

Related MCP server: Aave Liquidation MCP Server

快速入门

# Claude Code
claude mcp add graph-aave -- npx -y graph-aave-mcp

# Set Graph API key for subgraph tools (V4 tools work without it)
export GRAPH_API_KEY=your-key-here

{
  "mcpServers": {
    "graph-aave": {
      "command": "npx",
      "args": ["-y", "graph-aave-mcp"],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

免费 Graph API 密钥：thegraph.com/studio (每月 10 万次查询免费额度)。

托管部署 (无需安装)：Fronteir AI

V2/V3 工具 (The Graph 子图)

15 个工具 + 1 个原始查询入口。需要 GRAPH_API_KEY。

发现

工具	描述
`list_aave_chains`	所有支持的链，包含子图 ID、版本、30 天查询量
`get_aave_schema`	任何链的完整 GraphQL 模式内省

借贷市场

工具	描述
`get_aave_reserves`	所有活跃市场 — TVL、存款/借款 APY、LTV、清算阈值
`get_aave_reserve`	单个资产的深度详情：生命周期统计、配置、代币地址
`get_reserve_rate_history`	历史 APY、利用率、TVL 快照

用户头寸

工具	描述
`get_aave_user_position`	钱包的存款/借款资产、抵押品标记、e-mode
`simulate_health_factor`	模拟价格变动对用户健康因子的影响

协议事件

工具	描述
`get_recent_borrows`	近期借款 — 按用户或资产筛选
`get_recent_supplies`	近期存款 (自动处理 V2 与 V3 模式差异)
`get_aave_repays`	近期还款
`get_aave_liquidations`	近期清算 — 按用户或清算人筛选
`get_aave_flash_loans`	近期闪电贷及费用

治理

工具	描述
`get_governance_proposals`	包含标题、状态、投票数的提案
`get_proposal_votes`	按投票权划分的投票者明细

高级

工具	描述
`query_aave_subgraph`	原始 GraphQL — 对任何链执行任何查询

支持的链 (V2/V3)

链	版本	30 天查询量
Ethereum	V3	21.6M
Base	V3	5.6M
Arbitrum	V3	5.6M
Polygon	V3	2.0M
Optimism	V3	1.8M
Avalanche	V3	1.2M
Ethereum	V2	701K
Polygon	V2	216K
Avalanche	V2	133K
Fantom	V3 (Messari)	13K
Ethereum	Governance V3	486K

清算风险工具 (新增)

8 个由 5 条链上的专用风险子图驱动的工具。需要 GRAPH_API_KEY。

实时清算风险监控，包含健康因子、风险评分 (0–100)、风险等级分类（安全/警告/危险/严重）以及跨链风险汇总。

风险监控

工具	描述
`get_at_risk_positions`	处于清算风险中的头寸 — 按风险等级筛选，按风险评分排序
`get_user_risk_profile`	钱包的完整风险概况 — 所有头寸的健康因子和风险评分
`get_protocol_risk_stats`	汇总统计：总头寸数、危险/警告/严重等级计数
`get_cross_chain_risk_summary`	一次调用获取所有 5 条链的风险概览

风险事件

工具	描述
`get_risk_alerts`	风险等级转换 — 当头寸在安全/警告/危险/严重之间变动时
`get_risk_liquidations`	包含抵押品/债务资产、金额和交易哈希的清算事件
`get_health_factor_history`	特定钱包的健康因子趋势

发现

工具	描述
`list_risk_chains`	可用的清算风险链，包含子图 ID 和查询量

支持的链 (清算风险)

链	30 天查询量	信号
Ethereum	21.1K	20.2K GRT
Arbitrum	19.3K	35.7K GRT
Base	16.2K	15.2K GRT
Polygon	13.2K	—
Optimism	13.0K	—

V4 工具 (Aave API)

16 个由 api.aave.com/graphql 驱动的工具。无需 API 密钥。

流动性模型

工具	描述
`get_v4_hubs`	流动性中心 (Core, Plus, Prime)，包含 TVL 和利用率
`get_v4_spokes`	跨链分支 (Main, Bluechip, Kelp, Lido, Ethena, EtherFi, Forex, Gold, Lombard)
`get_v4_reserves`	每个分支的储备金，包含存款/借款 APY、风险参数、上限
`get_v4_chains`	支持的 V4 链
`get_v4_asset`	跨中心资产汇总，包含平均 APY 和价格
`get_v4_exchange_rate`	通过 Chainlink 预言机获取任何代币价格 (ERC-20, 原生, 或法币)
`get_v4_asset_price_history`	历史代币价格
`get_v4_protocol_history`	随时间变化的存款/借款总额

用户数据

工具	描述
`get_v4_user_positions`	跨链头寸 — 健康因子、抵押品、债务、借款能力
`get_v4_user_summary`	汇总投资组合：总头寸、净余额、净 APY
`get_v4_user_supplies`	包含本金和利息的存款头寸
`get_v4_user_borrows`	包含债务明细的借款头寸
`get_v4_user_balances`	跨链代币持有量，包含每个代币的最佳 APY
`get_v4_user_activities`	交易历史：存款、借款、还款、清算、兑换
`get_v4_claimable_rewards`	可领取的 Merkl 和积分奖励
`get_v4_swap_quote`	通过 CoW Protocol 获取只读兑换报价 (MEV 保护)

V4 架构

Hubs (Core, Plus, Prime)
  └── Assets (WETH, USDC, GHO, cbBTC, etc.)
       └── Spokes (Main, Bluechip, Kelp, Lido, Ethena, ...)
            └── Reserves (per-spoke lending markets)
                 └── User Positions (health factor, collateral, debt)

V4 支持跨链借贷：在一个分支存款，在另一个分支借款。中心汇总各分支的流动性。

引导式提示词

7 个预构建的工作流，引导代理进行多步分析：

提示词	描述
`analyze_aave_user`	完整的钱包分析：头寸、健康因子、清算风险
`aave_chain_overview`	协议概览：顶级市场、利率、近期活动
`compare_aave_rates`	比较所有链上单个资产的 APY
`aave_liquidation_analysis`	清算模式、顶级清算人、高风险市场
`aave_governance_overview`	近期提案、投票结果、活跃决策
`aave_full_stack_analysis`	跨版本比较：V2 vs V3 vs V4 利率和头寸
`cross_chain_risk_monitor`	新增 — 跨链清算风险：最高风险头寸、警报、协议健康状况

问题示例

清算风险 (新增):

“Arbitrum 上哪些 Aave 头寸最接近清算？”
“给我一个跨链风险仪表板 — 哪个网络的高风险头寸最多？”
“钱包 0x... 在任何链上有清算风险吗？”
“显示近期的风险警报 — 哪些头寸刚刚变得危险？”
“该钱包在 Base 上的健康因子随时间发生了什么变化？”

V4:

“Aave V4 中心及其利用率是多少？”
“显示存款 APY 最高的 V4 储备金”
“Aave V4 上当前的 ETH 价格是多少？”
“比较 V3 与 V4 的 USDC 存款利率”
“Aave V4 在以太坊上有哪些分支？”

V2/V3:

“以太坊上按 TVL 排名的顶级 AAVE 市场有哪些？”
“比较所有 V3 链上的 WETH 借款利率”
“分析钱包 0x... 的 AAVE 头寸”
“如果 ETH 下跌 30%，地址 0x... 会被清算吗？”
“显示以太坊上最近的 20 次清算”
“有哪些活跃的 AAVE 治理提案？”

开发

git clone https://github.com/PaulieB14/graph-aave-mcp.git
cd graph-aave-mcp
npm install
npm run build
GRAPH_API_KEY=your-key node build/index.js

许可证

MIT

Graph AAVE MCP