MCP Paradex Сервер

Реализация сервера Model Context Protocol (MCP) для торговой платформы Paradex.

Обзор

Этот проект обеспечивает мост между помощниками ИИ (такими как Клод) и платформой торговли бессрочными фьючерсами Paradex. Используя стандарт MCP, помощники ИИ могут:

Получить рыночные данные из Paradex
Управляйте торговыми счетами и хранилищами
Размещение и управление заказами
Мониторинг позиций и баланса

Предпосылки

Питон 3.10+

Установка

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

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

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

Использование УФ (более быстрая альтернатива)

Клонируйте этот репозиторий:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
Создайте виртуальную среду:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
Установить зависимости:
uv pip install -e .

Конфигурация

Настройте свою конфигурацию:

cp .env.template .env

Затем отредактируйте файл .env , используя ваши учетные данные Paradex.

Запуск сервера

Докер (рекомендуется)

docker build . -t sv/mcp-paradex-py

В курсоре добавьте MCP как команду

Только для общественности

docker run --rm -i sv/mcp-paradex-py

Разрешить торговлю

docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=0xprivatekey -i sv/mcp-paradex-py

Интеграция Smithery.ai

Этот сервер MCP совместим с Smithery.ai — платформой для обнаружения и развертывания серверов MCP.

Конфигурация рабочего стола Клода

Чтобы использовать этот сервер с Claude Desktop через Smithery.ai:

Откройте Claude Desktop и включите режим разработчика в меню.
Перейдите в «Настройки» > «Разработчик» и нажмите «Изменить конфигурацию».
Добавьте следующую конфигурацию в ваш claude_desktop_config.json :

{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

Замените your_ethereum_private_key на ваш настоящий закрытый ключ Paradex.
Сохраните файл и перезапустите Claude Desktop.

Реестр Smithery.ai

Сервер включает файл smithery.yaml с метаданными для реестра Smithery.ai. Если вы хотите опубликовать этот сервер в Smithery.ai, вы можете использовать Smithery CLI:

# Install Smithery CLI
npm install -g @smithery/cli

# Login to Smithery
smithery login

# Publish the server
smithery publish

Дополнительную информацию о публикации в Smithery.ai см. в документации Smithery .

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

Ресурсы

Системные ресурсы

paradex://system/config — получить конфигурацию системы Paradex и основную информацию об обмене
paradex://system/time - Получить текущее системное время в миллисекундах с начала эпохи
paradex://system/state — Получить текущее рабочее состояние системы Paradex

Ресурсы рынка

paradex://markets — Получите список доступных рынков от Paradex
paradex://market/summary/{market_id} — Получите подробную информацию о рынке для определенной торговой пары

Ресурсы хранилища

paradex://vaults — список всех хранилищ, доступных на Paradex
paradex://vaults/config — Получить глобальную конфигурацию для хранилищ
paradex://vaults/balance/{vault_id} - Получить баланс определенного хранилища
paradex://vaults/summary/{vault_id} — получите полную сводку по хранилищу
paradex://vaults/transfers/{vault_id} - Получить историю депозитов и снятий для хранилища
paradex://vaults/positions/{vault_id} — Получить текущие торговые позиции для хранилища
paradex://vaults/account-summary/{vault_id} — Получить информацию о торговом счете для хранилища

Инструменты

Системные инструменты

paradex_system_config — Получить глобальную конфигурацию системы Paradex
paradex_system_state — Получить текущее состояние системы

Инструменты рынка

paradex_markets — получите подробную информацию о рынках, включая базовые/котируемые активы, размер тика и другие торговые параметры
paradex_market_summaries — получайте сводки по цене, объему, 24-часовым изменениям и другим ключевым рыночным показателям.
paradex_funding_data — Получите исторические данные по ставкам финансирования для бессрочных рынков
paradex_orderbook — Получить текущую книгу заявок для рынка с настраиваемой глубиной
paradex_klines — Получить исторические данные свечей (OHLCV) для рынка
paradex_trades — Получите последние сделки на рынке с информацией о цене, размере и временной метке
paradex_bbo - Получите лучшую цену покупки и продажи (самый узкий спред) для рынка

Инструменты для работы с аккаунтом

paradex_account_summary - Получить сводную информацию по счету
paradex_account_positions - Получить текущие позиции по счету
paradex_account_fills - Получить торговые заполнения счета
paradex_account_funding_payments - Получайте платежи по финансированию счета
paradex_account_transactions - Получить историю транзакций по счету

Заказать инструменты

paradex_open_orders — Получить все открытые заказы для аккаунта
paradex_create_order - Создать новый заказ на Paradex
paradex_cancel_orders - Отменить существующие заказы
paradex_order_status - Получить статус заказа
paradex_orders_history — Получить историю заказов для аккаунта

Инструменты хранилища

paradex_vaults — получите подробную информацию о конкретных хранилищах или обо всех хранилищах с возможностью фильтрации
paradex_vaults_config — получение глобальной конфигурации для хранилищ, включая комиссии, лимиты и другие настройки.
paradex_vault_balance — Получить текущий баланс хранилища с информацией о доступных/заблокированных средствах
paradex_vault_summary — получите полную сводку о производительности, балансе и активности хранилища
paradex_vault_transfers - Получить историю депозитов и снятий для хранилища
paradex_vault_positions — получение текущих торговых позиций для хранилища с подробной информацией о рынке, размере и цене входа
paradex_vault_account_summary — получение информации о торговом счете для хранилища, включая показатели маржи и риска

Подсказки по торговому анализу

Этот сервер MCP предоставляет структурированные подсказки, которые помощники ИИ могут использовать для проведения сложного торгового анализа и создания торговых стратегий.

Анализ рынка

market_overview — получите полный обзор рынка криптовалют, включая лидеров роста/падения, рынки с высоким объемом, аномалии ставок финансирования и анализ микроструктуры рынка.
market_analysis — подробный технический и микроструктурный анализ конкретного рынка с уровнями поддержки/сопротивления, графическими моделями, анализом книги ордеров и рекомендациями по позициям

Управление позициями и портфелем

position_management - комплексный анализ существующих позиций, включая теплоту портфеля, корреляцию, показатели риска и конкретные рекомендации по фиксации прибыли и управлению убытками
create_optimal_order — разработка оптимальных параметров ордера для рынка на основе волатильности, ликвидности, толерантности к риску и идеальной стратегии входа
hedging_strategy - Разработка эффективных стратегий хеджирования для конкретных позиций с использованием корреляционного анализа, расчета коэффициента хеджирования и планирования внедрения
portfolio_risk_assessment - Тщательный анализ рисков торгового портфеля, включая анализ подверженности риску, оценку корреляции, расчеты VaR и рекомендации по снижению рисков
liquidation_protection — выявление и снижение рисков ликвидации открытых позиций с помощью классификации серьезности и стратегий защиты

Инвестиционные стратегии

vault_analysis — комплексный анализ хранилищ для принятия инвестиционных решений с показателями производительности, профилями рисков и оценкой пригодности
funding_rate_opportunity — выявление и оценка возможностей арбитража ставок финансирования на разных рынках, включая расчеты доходности и стратегии реализации
trading_consultation — Интерактивная последовательность подсказок для персонализированных торговых советов и консультаций

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

Мы увидели значительно лучшие результаты, предоставив клиентам доступ к документации Paradex.

"paradex-docs-mcp": {
   "command": "uvx",
   "args": [
      "--from",
      "mcpdoc",
      "mcpdoc",
      "--urls",
      "Paradex:https://docs.paradex.trade/llms.txt",
      "--transport",
      "stdio"
   ]
}

Внося вклад

Информацию о том, как внести свой вклад в этот проект, а также о настройках разработки и наших стандартах кодирования можно найти на сайте CONTRIBUTING.md .

Лицензия

Лицензия Массачусетского технологического института

Integrations