DexPaprika

DexPaprika MCP-сервер

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@latest

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

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

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

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

Критические изменения: Параметры переименованы в snake_case (poolAddress → pool_address, tokenAddress → token_address, orderBy → order_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.

Видеоурок

Посмотрите наш пошаговый урок по настройке и использованию 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 автоматически.

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

Если вы предпочитаете нулевую настройку, направьте любой 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/mcp	Прямой JSON-RPC

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

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

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

Обнаружение

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

Операции с DEX

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

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

Инструмент	Описание	Обязательные параметры
getNetworkPools	ОСНОВНОЙ — Получить топ пулов ликвидности в сети	network
getDexPools	Получить пулы конкретного DEX	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

Обратная связь

Инструмент	Описание	Обязательные параметры
submitFeedback	Сообщить о неожиданном поведении инструмента, отсутствующих данных или пробелах в документации напрямую команде	goal

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

// 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 с объемом >$100K за 24ч, созданные за последнюю неделю."
• "Сначала получи все доступные сети, затем покажи топ пулы в каждой основной сети."

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

• Лимиты бесплатного тарифа: 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 — см. файл LICENSE для подробностей.

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

• Документация API DexPaprika
• Размещенный MCP-сервер — Альтернатива без настройки
• Спецификация Model Context Protocol
• DexPaprika - Комплексные рыночные данные ончейн-аналитики
• CoinPaprika - Комплексные данные рынка криптовалют