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

# Clone the repository
git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server.git

# Navigate to the project directory
cd hyperliquid-mcp-server

# Install dependencies
npm install

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:

{
  "privateKey": "your-ethereum-private-key",
  "walletAddress": "your-wallet-address",
  "vaultAddress": "your-vault-address",
  "testnet": false,
  "logLevel": "info",
  "popularCoins": ["BTC", "ETH", "SOL", "AVAX", "ARB", "DOGE", "LINK", "MATIC"]
}

Uso

Inicie el servidor ejecutando:

npm start

O ejecute el cliente de demostración:

npm run demo

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)

Hyperliquid MCP Server

Integrations