graph-aave-mcp 是一个 MCP 服务器，用于查询 AAVE V2/V3/V4 的借贷与治理数据。它通过 The Graph 子图、Aave V4 API 以及 V4 Omnigraph 三种数据源，提供 51 个工具，覆盖 17 个 Graph 子图，支持 Ethereum、Base、Arbitrum、Polygon、Optimism、Avalanche、Fantom 共 7 条链以及 Governance V3。
用途方面，该服务器面向需要分析 AAVE 协议数据的场景，包括借贷市场状态、用户仓位、健康因子、跨链清算风险监控、清算记录、闪电贷、治理提案、V4 hubs/spokes、汇率、兑换报价、奖励与协议历史等。
主要能力分为几类。V2/V3 工具基于 The Graph 子图，提供 15 个工具加 1 个原始查询入口，需要 GRAPH_API_KEY。其中 get_aave_reserves 默认返回所有活跃储备，在 Ethereum 上为 67 个储备、约 28k tokens；可通过 symbols: ["USDC"] 指定单一资产（约 675 tokens），compact: true 仅返回利率，或使用 limit 限制行数。get_v4_reserves 同样支持这三种选项。清算风险工具为新增功能，包含 8 个工具，由专用风险子图驱动，覆盖 5 条链，需要 GRAPH_API_KEY，提供实时清算风险监控，包括健康因子、风险评分（0–100）、风险等级分类（safe/warning/danger/critical）以及跨链风险摘要。V4 工具基于 api.v4.aave.com/graphql，提供 17 个工具，无需 API 密钥（api.aave.com/graphql 为同一 schema 的别名，可通过 AAVE_V4_API_URL 覆盖）。V4 Omnigraph 工具基于 aave-v-4 子图（QmcKrCRSPrMABEfQjyPF6DqhbY7zzcEj6h5QxQmKLcHFSs），提供 5 个工具，需要 GRAPH_API_KEY，用于填补 Aave API 未暴露的数据缺口，包括 Hub↔Spoke 流动事件、每用户风险溢价轨迹、带完整溢价差上下文的清算事后分析、金库/费用/赤字核算以及治理轨迹快照。
使用方式上，用户需要获取免费的 Graph API 密钥（thegraph.com/studio，免费层每月 100K 次查询），也可选择托管部署（无需安装）。项目提供 7 个预构建工作流，引导代理完成多步分析。示例问题包括：Arbitrum 上哪些 Aave 仓位最接近清算、跨链风险仪表盘、某钱包是否在任何链上有清算风险、近期风险警报、某钱包在 Base 上健康因子随时间的变化、Aave V4 hubs 及其利用率、V4 储备中供应 APY 最高的资产、Aave V4 上 ETH 当前价格、V3 与 V4 USDC 供应利率对比、Aave V4 在 Ethereum 上的 spokes、Ethereum 上按 TVL 排名的顶级 AAVE 市场、所有 V3 链上 WETH 借款利率对比、分析某钱包的 AAVE 仓位、ETH 下跌 30% 时某地址是否会被清算、Ethereum 上最近 20 笔清算、当前活跃的 AAVE 治理提案等。
测试方面，test/smoke.mjs 通过 stdio 启动服务器并调用每个已注册工具，若任何工具返回错误或意外空集合则失败。后端在当前环境不可用（无 Graph 密钥、无可达 RPC）的工具会被跳过而非失败，因此该测试套件在无凭据时仍有意义，有凭据时则更全面。该测试的存在是因为 get_v4_hub_flows 曾指向未部署的子图而未被发现：Graph Studio 对缺失子图返回 HTTP 200 和 {"message":"Not found"}，客户端仅检查 GraphQL errors 键，工具返回 flows: []，与“链上无活动”无法区分。现在每个后端调用都会显式失败。
限制方面，V2/V3 工具、清算风险工具和 V4 Omnigraph 工具需要 GRAPH_API_KEY；V4 API 工具无需密钥。部分工具依赖特定子图或 RPC 的可用性。项目已发布至 MCP Registry，标识为 io.github.PaulieB14/graph-aave-mcp。环境变量等更多细节暂未提供。
