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로 게시됨

세 가지 데이터 소스

소스	버전	제공 내용	인증
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

청산 위험 도구 (신규)

5개 체인에 걸친 전용 위험 서브그래프 기반의 8개 도구. 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)

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`	모든 체인에 걸친 단일 자산의 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