graph-aave-mcp

npm version MCP Registry License: MIT

AAVE V2、V3、V4用MCPサーバー — 16個のGraphサブグラフ + Aave V4 APIを介した40個のツール。

レンディング市場、ユーザーポジション、ヘルスファクター、クロスチェーン清算リスク監視、清算、フラッシュローン、ガバナンス、V4ハブ/スポーク、為替レート、スワップ見積もり、報酬、プロトコル履歴をカバーしています。

MCP Registry に io.github.PaulieB14/graph-aave-mcp として公開されています。

3つのデータソース

ソース	バージョン	提供内容	認証
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`	1つの資産に関する詳細情報：ライフタイム統計、設定、トークンアドレス
`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

清算リスクツール (新規)

5つのチェーンにわたる専用のリスクサブグラフを活用した8個のツール。GRAPH_API_KEYが必要です。

ヘルスファクター、リスクスコア (0–100)、リスクレベル分類 (安全/警告/危険/致命的)、およびクロスチェーンリスクサマリーによるリアルタイムの清算リスク監視。

リスク監視

ツール	説明
`get_at_risk_positions`	清算リスクのあるポジション — リスクレベルでフィルタリングし、リスクスコア順にソート
`get_user_risk_profile`	ウォレットの完全なリスクプロファイル — ヘルスファクターとリスクスコアを含む全ポジション
`get_protocol_risk_stats`	集計統計：全ポジション数、危険/警告/致命的なポジション数
`get_cross_chain_risk_summary`	1回の呼び出しで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)

api.aave.com/graphql を活用した16個のツール。APIキーは不要です。

流動性モデル

ツール	説明
`get_v4_hubs`	TVLと利用率を含む流動性ハブ (Core, Plus, Prime)
`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`	全チェーンにわたる1つの資産の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はEthereum上にどのようなスポークを持っていますか？"

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

ライセンス

MIT

Graph AAVE MCP

graph-aave-mcp

3つのデータソース

クイックスタート

V2/V3ツール (The Graphサブグラフ)

ディスカバリー

レンディング市場

ユーザーポジション

プロトコルイベント

ガバナンス

高度な機能

サポート対象チェーン (V2/V3)

清算リスクツール (新規)

リスク監視

リスクイベント

ディスカバリー

サポート対象チェーン (清算リスク)

V4ツール (Aave API)

流動性モデル

ユーザーデータ

V4アーキテクチャ

ガイド付きプロンプト

質問例

開発

ライセンス

Resources

Latest Blog Posts

MCP directory API