Hyperliquid MCP Server

Servidor MCP de Hyperliquid

Un servidor de Protocolo de Contexto de Modelo (MCP) integral que envuelve el SDK de Hyperliquid y proporciona capacidades de comercio de criptomonedas a los asistentes de IA.

Descripción general

Este servidor MCP permite que los asistentes de IA interactúen con el exchange Hyperliquid para recuperar datos de mercado, ejecutar operaciones, gestionar posiciones y más. Implementa el Protocolo de Contexto de Modelo para ofrecer la gama completa de funciones de trading.

Características

• Implementación completa de todas las API del SDK de Hyperliquid tanto para operaciones al contado como de futuros
• Recuperación de datos de mercado (precios, libros de órdenes, velas)
• Colocación y gestión de órdenes (mercado, límite, disparador, TWAP)
• Gestión de posiciones (apalancamiento, margen, cierre)
• Información y saldos de cuentas
• Información sobre la tasa de financiación
• Transferencias y retiros
• Gestión de bóvedas
• Gestión de subcuentas
• Integración del sistema de referencias

Características técnicas

• Autenticación adecuada utilizando tanto la clave privada como la dirección de la billetera
• Manejo integral de errores y validación
• Acceso a datos de mercado en tiempo real
• Soporte para identificadores de pedidos de clientes (cloid) para seguimiento de pedidos
• Soporte tanto para testnet como para mainnet

Prerrequisitos

• Node.js (v14 o superior)
• Una cuenta hiperlíquida
• Una clave privada de Ethereum para autenticación (necesaria para el comercio)
• La dirección de su billetera (requerida para operar)

Instalación

Configuración

El servidor se puede configurar utilizando variables de entorno o un archivo de configuración:

Variables de entorno

• HYPERLIQUID_PRIVATE_KEY : Su clave privada de Ethereum para autenticación (requerida para operar)
• HYPERLIQUID_WALLET_ADDRESS : La dirección de su billetera (necesaria para operar)
• HYPERLIQUID_VAULT_ADDRESS : Su dirección de bóveda (opcional, para operaciones de bóveda)
• HYPERLIQUID_TESTNET : Establézcalo en 'verdadero' para usar la red de prueba, en 'falso' para la red principal (valor predeterminado: falso)
• LOG_LEVEL : Nivel de registro: 'depuración', 'información', 'advertencia' o 'error' (predeterminado: 'información')

Archivo de configuración

También puede crear un archivo .hyperliquid-config.json en el mismo directorio que el servidor con la siguiente estructura:

Uso

Inicie el servidor ejecutando:

O ejecute el cliente de demostración:

Herramientas disponibles

El servidor proporciona un conjunto completo de herramientas para interactuar con el intercambio de Hyperliquid. A continuación, se muestran algunos ejemplos:

Herramientas de datos de mercado

• getMarketPrice : obtiene el precio actual de una criptomoneda específica
• getOrderBook : obtiene el libro de órdenes actual para una criptomoneda específica
• getCandleData : obtiene datos históricos de velas para una criptomoneda específica
• getAllMids : Obtenga todos los precios medios de todas las criptomonedas disponibles

Herramientas de información de la cuenta

• getAccountInfo : obtiene información sobre la cuenta de futuros perpetuos del usuario
• getSpotAccountInfo : obtiene información sobre la cuenta de operaciones al contado del usuario
• getUserOpenOrders : obtiene todos los pedidos abiertos para el usuario
• getUserFills : obtiene los rellenos recientes del usuario

Herramientas de gestión de pedidos

• placeMarketOrder : Realizar una orden de mercado para una criptomoneda específica
• placeLimitOrder : coloca una orden limitada para una criptomoneda específica
• placeTriggerOrder : coloca una orden de activación (stop loss o take profit)
• placeTwapOrder : Realizar un pedido TWAP (Precio promedio ponderado en el tiempo)
• cancelOrder : Cancelar un pedido existente
• cancelOrderByCloid : Cancelar un pedido por ID de pedido del cliente
• cancelAllOrders : Cancelar todos los pedidos abiertos
• modifyOrder : Modificar un pedido existente

Consideraciones de seguridad

• Seguridad de la clave privada : Tu clave privada de Ethereum te da acceso completo a tus fondos. Nunca la compartas ni la expongas en repositorios públicos.
• Utilice Testnet primero : pruebe siempre su configuración en Testnet antes de utilizar fondos reales en Mainnet.
• Limitar acceso : restrinja el acceso al servidor MCP a aplicaciones y asistentes de IA confiables.

Descargo de responsabilidad

Operar con criptomonedas conlleva un riesgo significativo. Esta herramienta se proporciona únicamente con fines educativos e informativos. Siempre comprenda los riesgos antes de operar y nunca opere con fondos que no pueda permitirse perder.

Licencia

Instituto Tecnológico de Massachusetts (MIT)