graph-lending-mcp

Servidor MCP que expone herramientas unificadas compatibles con IA sobre los subgrafos de préstamos estandarizados de Messari en The Graph.

Una consulta en lenguaje natural → se distribuye a través de más de 40 protocolos de préstamo en 15 cadenas → devuelve datos estructurados y comparables.

Características

• 19 herramientas MCP que cubren protocolos, mercados, tasas, posiciones, eventos, instantáneas y análisis entre protocolos

• 90 despliegues de subgrafos en más de 40 protocolos de préstamo en 15 cadenas (Ethereum, Polygon, Arbitrum, Avalanche, BSC, Optimism, Base, Scroll, Fantom, Gnosis, Moonbeam y más)

• Comparación entre protocolos — compara TVL, ingresos y usuarios entre cualquier conjunto de protocolos en una sola llamada

• Gestión elegante de fallos — los subgrafos inactivos no bloquean las consultas; los fallos se informan junto con los éxitos

• Consciente de la versión del esquema — selecciona automáticamente consultas compatibles para subgrafos v1.x, v2.x y v3.x

Related MCP server: graph-polymarket-mcp

Herramientas

Configuración

Requisitos previos

• Node.js 18+

• Una clave de API de Graph de The Graph Studio

Inicio rápido (npm)

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

Instalación desde el código fuente

git clone https://github.com/PaulieB14/graph-lending-mcp.git
cd graph-lending-mcp
npm install
npx tsc

Luego, añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "graph-lending": {
      "command": "node",
      "args": ["/path/to/graph-lending-mcp/dist/index.js"],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Arquitectura

src/
├── index.ts          # MCP server entry — registers all 19 tools
├── registry.ts       # Protocol → subgraph ID mapping (see SUBGRAPHS.md)
├── client.ts         # GraphQL fetch with retry, timeout, fan-out
├── queries.ts        # All GraphQL query constants
└── tools/
    ├── protocol.ts   # list_protocols, get_protocol
    ├── markets.ts    # get_markets, get_market
    ├── rates.ts      # get_interest_rates
    ├── positions.ts  # get_account, get_positions
    ├── events.ts     # deposits, borrows, repays, withdrawals, liquidations, flashloans
    ├── snapshots.ts  # daily_financials, market_snapshots, usage_metrics
    └── cross.ts      # compare_protocols, top_markets_by_tvl

Todas las consultas utilizan el esquema de préstamos estandarizado de Messari: las mismas entidades y campos en todos los protocolos.

Registro de subgrafos

Consulta SUBGRAPHS.md para ver la lista completa de los 90 despliegues de subgrafos registrados con su estado, red, versión de esquema y notas.

Licencia

MIT