graph-lending-mcp

MCP-сервер, предоставляющий унифицированные инструменты для ИИ на основе стандартизированных подграфов кредитования Messari в The Graph.

Один запрос на естественном языке → распределение по 40+ протоколам кредитования в 15 сетях → получение структурированных, сопоставимых данных.

Возможности

• 19 инструментов MCP, охватывающих протоколы, рынки, ставки, позиции, события, снимки состояния и кросс-протокольную аналитику

• 90 развертываний подграфов для 40+ протоколов кредитования в 15 сетях (Ethereum, Polygon, Arbitrum, Avalanche, BSC, Optimism, Base, Scroll, Fantom, Gnosis, Moonbeam и другие)

• Кросс-протокольное сравнение — сравнение TVL, выручки и количества пользователей для любого набора протоколов в одном вызове

• Корректная обработка ошибок — неработающие подграфы не приводят к сбою запросов; ошибки сообщаются наряду с успешными результатами

• Учет версий схемы — автоматический выбор совместимых запросов для подграфов версий v1.x, v2.x и v3.x

Related MCP server: graph-polymarket-mcp

Инструменты

Настройка

Предварительные требования

• Node.js 18+

• API-ключ Graph из The Graph Studio

Быстрый старт (npm)

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

Установка из исходного кода

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

Затем добавьте в ваш 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"
      }
    }
  }
}

Архитектура

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

Все запросы используют стандартизированную схему кредитования от Messari — одинаковые сущности и поля для каждого протокола.

Реестр подграфов

См. SUBGRAPHS.md для получения полного списка из 90 зарегистрированных развертываний подграфов с указанием их статуса, сети, версии схемы и примечаний.

Лицензия

MIT