DexPaprika

Сервер MCP DexPaprika

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

TL;DR

# Install globally
npm install -g dexpaprika-mcp

# Start the server
dexpaprika-mcp

# Or run directly without installation
npx dexpaprika-mcp@latest

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

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

Последний релиз

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

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

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

Установка

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

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

npx -y smithery mcp add coinpaprika/dexpaprika

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

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

# Start the server
dexpaprika-mcp

Это stdio-сервер: он общается через MCP по stdin и stdout и не привязывается к порту. При запуске он записывает DexPaprika MCP server v<version> (tool contract v<contract>) is running... в stderr и затем ожидает клиента. Запускайте его из MCP-клиента (Claude Desktop, Cursor, Claude Code), а не ожидайте URL в браузере.

Видеоурок

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

Интеграция с 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@latest"]
    }
  }
}

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

Необязательно: использование ключа API

Это работает без ключа и будет работать всегда. Никакой регистрации, никакой карты, ничего настраивать не нужно. Всё вышеописанное — поддерживаемый способ запуска.

Бесплатный ключ повышает месячный лимит и открывает стриминг по любому токену, а не только по публичному демонстрационному набору. Он не повышает лимит запросов в минуту, который одинаков на обоих тарифах. Получите его на console.dexpaprika.com; текущие лимиты указаны на странице лимитов.

{
  "mcpServers": {
    "dexpaprika": {
      "command": "npx",
      "args": ["dexpaprika-mcp@latest"],
      "env": {
        "DEXPAPRIKA_API_KEY": "your_key_here"
      }
    }
  }
}

Ключ вставляется сам по себе. Нет префикса Bearer, как и любого другого слова схемы. Вставьте ключ точно так, как он был выдан. Почти каждый другой API требует обратного, поэтому это самая распространённая причина, по которой рабочий ключ выглядит сломанным.

Две вещи, которые стоит знать:

• Ключ, который мы не можем прочитать, не вызывает ошибку. Конечные точки данных игнорируют нечитаемый ключ и обслуживают вас как анонимного вызывающего, с обычным 200 и реальными данными, поэтому опечатка выглядит точно как успех. Попросите ассистента выполнить getKeyStatus после установки ключа: он сообщит, какой план API видит на самом деле, и назовёт вероятную причину, если ключ не применяется.
• Клиенты Pro дополнительно устанавливают DEXPAPRIKA_API_BASE_URL на https://api-pro.dexpaprika.com. Хост не меняется автоматически, потому что отправка бесплатного ключа на этот хост возвращает 403.

Хостируемый сервер (без установки)

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

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

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

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

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

Эта сборка для самостоятельного размещения регистрирует 17 инструментов чтения: 16 инструментов рыночных данных плюс getKeyStatus. Хостируемый сервер на mcp.dexpaprika.com регистрирует собственный набор, включая submitFeedback. Проверьте любой из них с помощью живого tools/list.

Обнаружение

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

Операции с DEX

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

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

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

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

Инструмент	Описание	Обязательные параметры
getTokenDetails	Подробная информация о токене	network, token_address
getTokenPools	Пулы ликвидности, содержащие токен (фильтр по сети, results + курсорная пагинация)	network, token_address
getTokenMultiPrices	Пакетные цены для до 10 токенов	network, tokens[]
getTopTokens	Топ-токены в сети, отсортированные по объёму, ликвидности, FDV или изменению цены за 24 часа	network
filterNetworkTokens	Фильтрация токенов по объёму, ликвидности, FDV, транзакциям и времени создания	network

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

// 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 pools containing a token (returns `results` with cursor pagination;
// the token filter only works network-scoped):
const jupiterPools = await getTokenPools({
  network: "solana",
  token_address: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  order_by: "volume_usd_24h",
  limit: 5
});

// Get top pools on Ethereum (returns `results` with cursor pagination):
const ethereumPools = await getNetworkPools({
  network: "ethereum",
  order_by: "volume_usd_24h",
  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_usd_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, созданные за последнюю неделю."
• "Сначала получите все доступные сети, затем покажите топ-пулы в каждой крупной сети."

Лимиты запросов и производительность

• Бесплатный тариф: без ключа, без регистрации, 30 запросов в минуту. Бесплатный ключ API повышает месячную квоту и открывает стриминг. Pro стоит $99/месяц при 300 запросах в минуту. Один запрос стоит один кредит; пакетные конечные точки стоят один кредит за элемент. Месячные квоты меняются, поэтому читайте их здесь, а не на этой странице: https://dexpaprika.com/api/pricing
• Задержка данных: до 15 секунд на бесплатном тарифе, в реальном времени на Pro
• Время ответа: 100-500 мс для большинства конечных точек (зависит от сети)
• Обработка ошибок: Структурированные ошибки с кодами, предложениями и рекомендациями по повторным попыткам
• Доступность данных 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 для подробностей.

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

• Документация API DexPaprika
• Хостируемый MCP-сервер, вариант с нулевой настройкой
• Спецификация Model Context Protocol
• DexPaprika — комплексные рыночные данные ончейн-аналитики
• CoinPaprika — комплексные рыночные данные о криптовалютах