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 pip

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

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:
   uv pip install -e .

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

• system://status - Obtener el estado actual del sistema y la conexión Paradex
• system://version - Obtener información detallada de la versión del servidor y sus dependencias
• system://health - Realiza una comprobación básica del estado del servidor

Recursos del mercado

• market://public/markets - Obtenga una lista de los mercados disponibles de Paradex
• market://public/info - Obtenga información general y el estado del mercado

Recursos de la bóveda

• vaults://list - Lista todas las bóvedas asociadas con la cuenta
• vaults://balance - Obtener el saldo de una bóveda específica
• vaults://details - Obtenga información detallada sobre 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

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