MCP Paradex Server

Servidor MCP Paradex

Implementación del servidor de Protocolo de Contexto de Modelo (MCP) para la plataforma comercial Paradex.

Descripción general

Este proyecto conecta a los asistentes de IA (como Claude) con la plataforma de negociación de futuros perpetuos Paradex. Mediante el estándar MCP, los asistentes de IA pueden:

• Recuperar datos de mercado de Paradex
• Administrar cuentas comerciales y bóvedas
• Realizar y gestionar pedidos
• Monitorizar posiciones y equilibrio

Prerrequisitos

• Python 3.10+

Instalación

Instalación mediante herrería

Para instalar mcp-paradex-py para Claude Desktop automáticamente a través de Smithery :

Usando uv (alternativa más rápida)

1. Clonar este repositorio:
   git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
2. Crear un entorno virtual:
   uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Instalar dependencias:

Configuración

Configura tu configuración:

Luego edite el archivo .env con sus credenciales de Paradex.

Ejecución del servidor

Docker (recomendado)

En Cursor agregar MCP como comando

Sólo público

Permitir el comercio

Integración de Smithery.ai

Este servidor MCP es compatible con Smithery.ai , una plataforma para descubrir e implementar servidores MCP.

Configuración del escritorio de Claude

Para utilizar este servidor con Claude Desktop a través de Smithery.ai:

1. Abra Claude Desktop y habilite el modo de desarrollador desde el menú
2. Vaya a Configuración > Desarrollador y haga clic en "Editar configuración".
3. Agregue la siguiente configuración a su claude_desktop_config.json :

4. Reemplace your_ethereum_private_key con su clave privada real de Paradex
5. Guarde el archivo y reinicie Claude Desktop

Registro de Smithery.ai

El servidor incluye un archivo smithery.yaml con metadatos para el registro de Smithery.ai. Si desea publicar este servidor en Smithery.ai, puede usar la CLI de Smithery:

Para obtener más información sobre cómo publicar en Smithery.ai, consulte la documentación de Smithery .

Recursos y herramientas disponibles

Recursos

Recursos del sistema

• paradex://system/config - Obtener la configuración del sistema Paradex e información básica sobre el intercambio
• paradex://system/time - Obtiene la hora actual del sistema en milisegundos desde la época
• paradex://system/state - Obtener el estado operativo actual del sistema Paradex

Recursos del mercado

• paradex://markets - Obtenga una lista de los mercados disponibles de Paradex
• paradex://market/summary/{market_id} - Obtenga información detallada del mercado para un par comercial específico

Recursos de la bóveda

• paradex://vaults - Lista todas las bóvedas disponibles en Paradex
• paradex://vaults/config - Obtener la configuración global para las bóvedas
• paradex://vaults/balance/{vault_id} - Obtener el saldo de una bóveda específica
• paradex://vaults/summary/{vault_id} - Obtenga un resumen completo de una bóveda
• paradex://vaults/transfers/{vault_id} - Obtener el historial de depósitos y retiros de una bóveda
• paradex://vaults/positions/{vault_id} - Obtener las posiciones comerciales actuales de una bóveda
• paradex://vaults/account-summary/{vault_id} - Obtener información de la cuenta comercial para una bóveda

Herramientas

Herramientas del sistema

• paradex_system_config : obtiene la configuración global del sistema Paradex
• paradex_system_state - Obtener el estado actual del sistema

Herramientas de mercado

• paradex_markets : obtenga información detallada sobre los mercados, incluidos los activos base/cotizados, el tamaño del tick y otros parámetros comerciales
• paradex_market_summaries : obtenga resúmenes con precio, volumen, cambios en 24 horas y otras métricas clave del mercado.
• paradex_funding_data : Obtenga datos históricos de tasas de financiación para mercados perpetuos
• paradex_orderbook : obtiene el libro de órdenes actual para un mercado con profundidad personalizable
• paradex_klines - Obtener datos históricos de velas japonesas (OHLCV) para un mercado
• paradex_trades : obtenga operaciones recientes de un mercado con información de precio, tamaño y marca de tiempo
• paradex_bbo - Obtenga la mejor oferta y demanda (spread más ajustado) para un mercado

Herramientas de cuenta

• paradex_account_summary - Obtener información resumida de la cuenta
• paradex_account_positions - Obtener las posiciones actuales de la cuenta
• paradex_account_fills - Obtener rellenos de comercio de cuenta
• paradex_account_funding_payments - Recibir pagos de financiación de la cuenta
• paradex_account_transactions - Obtener el historial de transacciones de la cuenta

Herramientas de pedido

• paradex_open_orders - Obtener todos los pedidos abiertos para una cuenta
• paradex_create_order - Crea un nuevo pedido en Paradex
• paradex_cancel_orders - Cancelar pedidos existentes
• paradex_order_status - Obtener el estado de un pedido
• paradex_orders_history - Obtener el historial de pedidos de una cuenta

Herramientas de bóveda

• paradex_vaults : obtenga información detallada sobre bóvedas específicas o todas las bóvedas con opciones de filtrado
• paradex_vaults_config : obtiene la configuración global para bóvedas, incluidas tarifas, límites y otras configuraciones
• paradex_vault_balance : obtiene el saldo actual de una bóveda con información de fondos disponibles/bloqueados
• paradex_vault_summary : obtenga un resumen completo del rendimiento, el equilibrio y la actividad de la bóveda
• paradex_vault_transfers - Obtener el historial de depósitos y retiros de una bóveda
• paradex_vault_positions : obtenga las posiciones comerciales actuales de una bóveda con detalles del mercado, tamaño y precio de entrada
• paradex_vault_account_summary : obtenga información de la cuenta comercial de una bóveda, incluidas las métricas de margen y riesgo

Indicaciones para el análisis comercial

Este servidor MCP proporciona indicaciones estructuradas que los asistentes de IA pueden utilizar para realizar análisis comerciales complejos y generar estrategias comerciales.

Análisis de mercado

• market_overview : Obtenga una descripción general completa del mercado de criptomonedas, incluidos los principales ganadores/perdedores, los mercados de alto volumen, las anomalías en la tasa de financiación y el análisis de la microestructura del mercado.
• market_analysis : análisis técnico y de microestructura detallado de un mercado específico, con niveles de soporte/resistencia, patrones gráficos, análisis del libro de órdenes y recomendaciones de posiciones.

Gestión de posiciones y carteras

• position_management - Análisis exhaustivo de las posiciones existentes, incluyendo el nivel de cartera, la correlación, las métricas de riesgo y recomendaciones específicas para la toma de ganancias y la gestión de pérdidas
• create_optimal_order : Diseñe parámetros de orden óptimos para un mercado en función de la volatilidad, la liquidez, la tolerancia al riesgo y la estrategia de entrada ideal.
• hedging_strategy : desarrolle estrategias de cobertura efectivas para posiciones específicas utilizando análisis de correlación, cálculo de índices de cobertura y planificación de implementación.
• portfolio_risk_assessment : análisis exhaustivo del riesgo de la cartera de operaciones, que incluye análisis de exposición, evaluación de correlación, cálculos de VaR y recomendaciones de reducción de riesgos.
• liquidation_protection - Identificar y mitigar los riesgos de liquidación de posiciones abiertas con clasificación de gravedad y estrategias de protección

Estrategias de inversión

• vault_analysis : análisis integral de bóvedas para la toma de decisiones de inversión, con métricas de rendimiento, perfiles de riesgo y evaluación de idoneidad
• funding_rate_opportunity : identificar y evaluar oportunidades de arbitraje de tasas de financiación en los mercados, incluidos cálculos de rendimiento y estrategias de implementación
• trading_consultation - Secuencia de indicaciones interactivas para asesoramiento y consulta comercial personalizados

Documentación MCP

Hemos visto resultados significativamente mejores al brindarle a los clientes acceso a la documentación de Paradex

Contribuyendo

Consulte CONTRIBUTING.md para obtener información sobre cómo contribuir a este proyecto, la configuración del desarrollo y nuestros estándares de codificación.

Licencia

Licencia MIT