graph-aave-mcp

graph-aave-mcp

AAVE V2、V3、V4 向けの MCP サーバー — 17 の Graph サブグラフにまたがる 57 個のツールに加え、Aave V4 API と V4 Omnigraph（REST API では取得できないデータ向け）。

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

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

3 つのデータソース

クイックスタート

# 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 トークンです。1 つのアセット（約 675 トークン）を取得するには symbols: ["USDC"] を、 レートのみを取得するには compact: true を、行数を制限するには limit を指定します。 get_v4_reserves も同じ 3 つのオプションを受け付けます。

ディスカバリー

レンディング市場

ユーザーポジション

プロトコルイベント

ガバナンス

高度な機能

対応チェーン（V2/V3）

清算リスクツール（新機能）

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

ヘルスファクター、リスクスコア（0～100）、リスクレベルの分類（安全／警告／危険／重大）を使ったリアルタイムの清算リスク監視と、クロスチェーンのリスク概要を提供します。

リスク監視

リスクイベント

検出

対応チェーン（清算リスク）

V4 ツール（Aave API）

api.v4.aave.com/graphql を利用する 17 個のツールです。API キーは不要です。（api.aave.com/graphql は同じスキーマの別名です。AAVE_V4_API_URL でどちらも上書きできます。）

注： V4 Omnigraph ツール（次のセクション）は REST API では公開されていない不足分を補い、GRAPH_API_KEY が必要です。以下に挙げる 16 個のツールは引き続きキー不要です。

流動性モデル

User Data

V4 Omnigraph ツール（サブグラフ — Aave API で取得できないデータを補完）

aave-v-4 サブグラフ（QmcKrCRSPrMABEfQjyPF6DqhbY7zzcEj6h5QxQmKLcHFSs）を利用する 5 つのツールです。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）（サブグラフ）です。Core/Plus/Prime の場合は network: "ethereum" を指定します。GRAPH_API_KEY が必要です。

例：「Aave V4 Base でトークン化株式を清算しているのは誰ですか？」 → get_v4_recent_liquidations。「Base の Stocks 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つあります。

質問の例

清算リスク（新機能）：

• 「Arbitrum上で清算が近いAaveのポジションはどれですか？」
• 「クロスチェーンのリスクダッシュボードを表示してください。リスクのあるポジションが最も多いネットワークはどれですか？」
• 「ウォレット0x...は、いずれかのチェーンで清算リスクがありますか？」
• 「最近のリスクアラートを表示してください。重大な状態になったポジションはどれですか？」
• 「Base上で、このウォレットのヘルスファクターは時間とともにどう変化しましたか？」

V4：

• 「Aave V4のハブとその利用率を教えてください」
• 「供給APYが最も高いV4のリザーブを表示してください」
• 「Aave V4で現在のETH価格はいくらですか？」
• 「V3とV4のUSDC供給金利を比較してください」
• 「Ethereum上にAave V4のスポークはいくつありますか？」

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はstdio経由でサーバーを起動し、登録されているすべてのツールを呼び出します。いずれかのツールがエラーを返すか、予期せず空のコレクションを返した場合、テストは失敗します。現在の環境でバックエンドを利用できないツール（Graphキーがない、または到達可能なRPCがない場合）は失敗とせずスキップされるため、認証情報がなくても有意義なテストを実行でき、認証情報があれば徹底的にテストできます。

このテストは、未デプロイのサブグラフを参照したままget_v4_hub_flowsがリリースされ、誰も気づかなかったことをきっかけに作成されました。Graph Studioはサブグラフが見つからない場合でもHTTP 200と{"message":"Not found"}を返し、クライアントはGraphQLのerrorsキーだけを確認していたため、このツールはflows: []を返していました。これは「チェーン上にアクティビティがない」状態と区別できません。現在では、すべてのバックエンド呼び出しがエラーを明示的に報告します。

環境変数

ライセンス

MIT