DexPaprika MCP Server

официальный

Access real-time DEX analytics across 20+ blockchains with DexPaprika API, tracking 5M+ tokens, pools, volumes, and historical market data. Built by CoinPaprika.

Документация

DexPaprika MCP Server

Сервер Model Context Protocol (MCP), предоставляющий доступ по требованию к API данных о криптовалютах и DEX от DexPaprika. Создан специально для AI-ассистентов, таких как Claude, для программного получения в реальном времени данных о токенах, пулах и DEX без какой-либо настройки.

Кратко

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp

DexPaprika MCP подключает Claude к живым данным DEX в нескольких блокчейнах. Ключи API не требуются. Установка | Конфигурация | Справочник API

Предпочитаете без настройки? Используйте размещённый MCP-сервер на mcp.dexpaprika.com — без установки, без ключа API, те же 14 инструментов. См. Размещённая альтернатива для транспортных конечных точек.

Основные обновления версии 1.3.0

Новые инструменты: getCapabilities (онбординг агента с рабочими процессами, синонимами, лучшими практиками) и getNetworkPoolsFilter (серверная фильтрация пулов по объёму, транзакциям, времени создания).

Критические изменения: Параметры переименованы в snake_case (poolAddresspool_address, tokenAddresstoken_address, orderByorder_by). Пагинация теперь начинается с 1. См. CHANGELOG.md для полного руководства по миграции.

Что можно создать?

  • Инструменты анализа токенов: Отслеживание движения цен, изменений глубины ликвидности и паттернов объёма
  • Сравнение DEX: Анализ структур комиссий, объёма и доступных пулов на разных DEX
  • Аналитика пулов ликвидности: Мониторинг изменений TVL, расчёт непостоянных потерь и оценка влияния на цену
  • Анализ рынка: Сравнение токенов между цепочками, тренды объёмов и метрики торговой активности
  • Трекеры портфеля: Отслеживание стоимости в реальном времени, анализ исторической доходности, возможности дохода
  • Технический анализ: Выполнение расширенного технического анализа с использованием исторических данных OHLCV, включая определение трендов, распознавание паттернов и расчёт индикаторов

Установка

Установка через Smithery

Чтобы установить DexPaprika для Claude Desktop автоматически через Smithery:

npx -y @smithery/cli install @coinpaprika/dexpaprika-mcp --client claude

Ручная установка

# Install globally (recommended for regular use)
npm install -g dexpaprika-mcp

# Verify installation
dexpaprika-mcp --version

# Start the server
dexpaprika-mcp

Сервер по умолчанию работает на порту 8010. При успешном запуске вы увидите MCP server is running at http://localhost:8010.

Видеоурок

Посмотрите наш пошаговый урок по настройке и использованию сервера DexPaprika MCP:

DexPaprika MCP Tutorial

Интеграция с Claude Desktop

Добавьте следующее в файл конфигурации Claude Desktop:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp"]
    }
  }
}

После перезапуска Claude Desktop инструменты DexPaprika станут доступны Claude автоматически.

Размещённая альтернатива (без установки)

Если вы предпочитаете нулевую настройку, направьте любой MCP-совместимый клиент прямо на размещённый сервер по адресу mcp.dexpaprika.com. Целевая страница содержит инструкции по настройке и документацию. Доступны следующие транспортные конечные точки:

ТранспортКонечная точкаВариант использования
Streamable HTTPhttps://mcp.dexpaprika.com/streamable-httpРекомендуется для большинства клиентов
SSEhttps://mcp.dexpaprika.com/sseУстаревший SSE-транспорт
JSON-RPChttps://mcp.dexpaprika.com/mcpПрямой JSON-RPC

Примечание: Это конечные точки протокола MCP — они ничего не отобразят в браузере. Посетите mcp.dexpaprika.com для целевой страницы.

{
  "mcpServers": {
    "dexpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.dexpaprika.com/streamable-http"
    }
  }
}

Доступные инструменты (14)

Обнаружение

ИнструментОписание
getCapabilitiesВозможности сервера, шаблоны рабочих процессов, сетевые синонимы и лучшие практики. Начните здесь.
getNetworksСписок всех 33 поддерживаемых блокчейн-сетей
getStatsВысокоуровневая статистика экосистемы (всего сетей, DEX, пулов, токенов)
searchПоиск токенов, пулов и DEX по ВСЕМ сетям по имени, символу или адресу

Операции с DEX

ИнструментОписаниеОбязательные параметры
getNetworkDexesСписок DEX в конкретной сетиnetwork

Операции с пулами

ИнструментОписаниеОбязательные параметры
getNetworkPoolsОСНОВНОЙ — Получить топ пулов ликвидности в сетиnetwork
getDexPoolsПолучить пулы конкретного DEXnetwork, dex
getNetworkPoolsFilterФильтровать пулы по объёму, транзакциям, времени созданияnetwork
getPoolDetailsДетальная информация о пуле (цена, объём, TVL, токены)network, pool_address
getPoolOHLCVИсторические данные свечей OHLCVnetwork, pool_address, start
getPoolTransactionsПоследние транзакции/сделки пулаnetwork, pool_address

Операции с токенами

ИнструментОписаниеОбязательные параметры
getTokenDetailsДетальная информация о токенеnetwork, token_address
getTokenPoolsПулы ликвидности, содержащие токенnetwork, token_address
getTokenMultiPricesПакетные цены до 10 токеновnetwork, tokens[]

Пример использования

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get details about a specific token:
const solanaJupToken = await getTokenDetails({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
});

// Find all pools for a specific token with volume sorting:
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd",
  limit: 5
});

// Get top pools on Ethereum:
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd",
  limit: 10
});

// Filter pools by volume and creation time:
const filteredPools = await getNetworkPoolsFilter({
  network: "ethereum",
  volume_24h_min: 100000,
  created_after: 1710806400,
  sort_by: "volume_24h",
  limit: 20
});

// Get historical price data:
const ohlcvData = await getPoolOHLCV({
  network: "ethereum",
  pool_address: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  start: "2023-01-01",
  interval: "24h",
  limit: 30
});

// Batch prices for multiple tokens (max 10):
const prices = await getTokenMultiPrices({
  network: "ethereum",
  tokens: [
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "0xdac17f958d2ee523a2206206994597c13d831ec7"
  ]
});

Примеры запросов для Claude

  • "Проанализируй токен JUP на Solana. Получи цену, объём и топ пулов ликвидности."
  • "Сравни торговый объём между Uniswap V3 и SushiSwap на Ethereum."
  • "Получи 7-дневные данные OHLCV для SOL/USDC на Raydium и построй график цены."
  • "Найди топ-5 пулов по ликвидности в сети Fantom и проанализируй их структуры комиссий."
  • "Получи последние транзакции для пула ETH/USDT на Uniswap и проанализируй давление покупателей и продавцов."
  • "Покажи топ-10 пулов на Ethereum по 24-часовому объёму."
  • "Найди все пулы, содержащие токен ARB, и отсортируй их по объёму."
  • "Отфильтруй пулы Ethereum с 24-часовым объёмом >$100K, созданные за последнюю неделю."
  • "Сначала получи все доступные сети, затем покажи топ пулов в каждой основной сети."

Ограничения скорости и производительность

  • Лимиты бесплатного тарифа: 10 000 запросов в день
  • Время ответа: 100-500 мс для большинства конечных точек (зависит от сети)
  • Свежесть данных: Данные пулов и токенов обновляются каждые 15-30 с
  • Обработка ошибок: Структурированные ошибки с кодами, предложениями и рекомендациями по повтору
  • Доступность данных OHLCV: Исторические данные обычно доступны с даты создания токена/пула

Устранение неполадок

Частые проблемы:

  • Ограничение скорости: При получении ошибок DP429_RATE_LIMIT реализуйте экспоненциальную задержку
  • Отсутствие данных: Некоторые новые токены/пулы могут иметь неполные исторические данные
  • Ошибки тайм-аута: Большие запросы данных могут выполняться дольше, рассмотрите пагинацию
  • Сетевые ошибки: Проверьте сетевое подключение, сервис требует доступа в интернет
  • Ограничения OHLCV: Максимальный диапазон между начальной и конечной датами — 1 год; используйте пагинацию для более длительных периодов
  • Пустой OHLCV: Пул может быть слишком новым — используйте вместо этого getPoolTransactions

Разработка

# Clone the repository
git clone https://github.com/coinpaprika/dexpaprika-mcp.git
cd dexpaprika-mcp

# Install dependencies
npm install

# Run with auto-restart on code changes
npm run watch

# Build for production
npm run build

# Run tests
npm test

История изменений

См. CHANGELOG.md для подробных заметок о выпусках и руководств по миграции.

Лицензия

Этот проект лицензирован под лицензией MIT — см. файл LICENSE для подробностей.

Дополнительные ресурсы