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 (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.
Видеоурок
Посмотрите наш пошаговый урок по настройке и использованию сервера DexPaprika MCP:
Интеграция с 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 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"
}
}
}
Доступные инструменты (14)
Обнаружение
| Инструмент | Описание |
|---|---|
getCapabilities | Возможности сервера, шаблоны рабочих процессов, сетевые синонимы и лучшие практики. Начните здесь. |
getNetworks | Список всех 33 поддерживаемых блокчейн-сетей |
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 | Пулы ликвидности, содержащие токен | 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 для подробностей.
Дополнительные ресурсы
- Документация DexPaprika API
- Размещённый MCP-сервер — Альтернатива без настройки
- Спецификация Model Context Protocol
- DexPaprika — Всесторонние ончейн-аналитические рыночные данные
- CoinPaprika — Всесторонние рыночные данные криптовалют
