graph-aave-mcp

graph-aave-mcp

面向 AAVE V2、V3 和 V4 的 MCP 服务——提供 57 个工具，覆盖 17 个 Graph 子图、Aave V4 API 和 V4 Omnigraph（用于获取 REST API 未公开的数据）。

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

已发布到 MCP Registry，名称为 io.github.PaulieB14/graph-aave-mcp

三种数据源

快速开始

# 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

# Optional but recommended: the two live on-chain tools read via RPC, and the
# unconfigured public fallback is rate-limited or blocked on many networks.
export ETHEREUM_RPC_URL=https://your-endpoint

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

免费 Graph API 密钥：thegraph.com/studio（免费套餐每月提供 100K 次查询）。

托管部署（无需安装）：Fronteir AI

V2/V3 工具（The Graph 子图）

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

响应大小。 get_aave_reserves 默认返回所有活跃储备—— 在 Ethereum 上有 67 个储备，约 28k 个 Token。传入 symbols: ["USDC"] 可只获取一种 资产（约 675 个 Token），传入 compact: true 仅获取利率，或使用 limit 限制行数。 get_v4_reserves 支持相同的三个选项。

发现

借贷市场

用户头寸

协议事件

治理

高级

支持的链（V2/V3）

清算风险工具（新增）

8 个工具由覆盖 5 条链的专用风险子图提供支持。需要 GRAPH_API_KEY。

实时监控清算风险，提供健康因子、风险评分（0–100）、风险等级分类（安全/警告/危险/严重）和跨链风险摘要。

风险监控

风险事件

发现

支持的链（清算风险）

V4 工具（Aave API）

17 个工具由 api.v4.aave.com/graphql 提供支持。无需 API 密钥。（api.aave.com/graphql 是同一架构的别名；可通过 AAVE_V4_API_URL 覆盖任一 URL。）

注意： V4 Omnigraph 工具（下一节）涵盖 REST API 未提供的数据，且需要 GRAPH_API_KEY。下方列出的 16 个工具仍无需密钥。

流动性模型

用户数据

V4 Omnigraph 工具（子图 — 补充 Aave API 未提供的数据）

由 aave-v-4 子图提供支持的 5 个工具 (QmcKrCRSPrMABEfQjyPF6DqhbY7zzcEj6h5QxQmKLcHFSs)。需要 GRAPH_API_KEY（与 V2/V3 子图工具使用的免费密钥相同）。

这些工具涵盖了 api.aave.com/graphql 在结构上无法返回的数据：Hub↔Spoke 流转事件、每位用户的风险溢价变化轨迹、包含完整溢价差额上下文的清算事后分析、金库/费用/亏空核算，以及治理过程快照。

V4 子图工具 — Base（Coinbase 代币化股票）+ Ethereum

由 Aave V4 子图提供支持的 6 个网络感知工具。默认值为 network: "base" — Base 上的 Coinbase Stocks hub（子图 9x1tg7KX3RXspnK7R1mahAZsM5gTmFhLrmJSbkoBsDdq）。传入 network: "ethereum" 可查询 Core/Plus/Prime。需要 GRAPH_API_KEY。

示例："谁在 Aave V4 Base 上清算代币化股票？" → get_v4_recent_liquidations。"Base 股票 hub 上的 USDC 借款利率和费用是多少？" → get_v4_hub_assets（约 2.1%，流动性费用为 10%）。

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 支持跨链借贷：在一个 Spoke 上供应，在另一个 Spoke 上借款。Hub 汇集各个 Spoke 的流动性。

引导式提示词

7 个预构建工作流，引导 Agent 完成多步骤分析：

示例问题

清算风险（新增）：

• “Arbitrum 上哪些 Aave 仓位最接近清算？”
• “给我一个跨链风险仪表板——哪个网络上存在风险的仓位最多？”
• “钱包 0x... 是否在任何链上面临清算风险？”
• “显示近期风险警报——哪些仓位刚刚变得危急？”
• “这个钱包在 Base 上的健康因子随时间发生了怎样的变化？”

V4：

• “Aave V4 有哪些 hub，它们的利用率是多少？”
• “显示供应 APY 最高的 V4 储备”
• “Aave V4 上当前 ETH 的价格是多少？”
• “比较 V3 和 V4 的 USDC 供应利率”
• “Aave V4 在 Ethereum 上有哪些 spoke？”

V2/V3：

• “按 TVL 排名，Ethereum 上最热门的 AAVE 市场有哪些？”
• “比较所有 V3 链上的 WETH 借款利率”
• “分析钱包 0x... 的 AAVE 仓位”
• “如果 ETH 下跌 30%，地址 0x... 会被清算吗？”
• “显示 Ethereum 上最近 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

测试

npm test                                     # V4 tools only
GRAPH_API_KEY=... ETHEREUM_RPC_URL=... npm test   # everything

test/smoke.mjs 通过标准输入输出启动服务，并调用每个已注册的工具；如果任何工具返回错误或意外的空集合，测试就会失败。当前环境中后端不可用的工具（没有 Graph 密钥或无法访问 RPC）会被跳过，而不是判定为失败。因此，即使没有凭据，测试套件也有意义；有凭据时则能进行全面测试。

编写此测试是因为 get_v4_hub_flows 上线时指向了一个尚未部署的子图，却无人察觉：Graph Studio 对不存在的子图返回 HTTP 200 和 {"message":"Not found"}，客户端只检查是否存在 GraphQL errors 键，而工具则返回 flows: []——这与“链上没有活动”无法区分。现在，每次后端调用都会明确报错。

环境变量

许可证

MIT