하이퍼리퀴드 MCP 서버

Hyperliquid SDK를 래핑한 포괄적인 MCP(Model Context Protocol) 서버로, AI 도우미에게 암호화폐 거래 기능을 제공합니다.

개요

이 MCP 서버는 AI 비서가 Hyperliquid 거래소와 상호 작용하여 시장 데이터 검색, 거래 실행, 포지션 관리 등의 작업을 수행할 수 있도록 지원합니다. 모델 컨텍스트 프로토콜(MCP)을 구현하여 모든 거래 기능을 제공합니다.

특징

현물 및 선물 거래를 위한 모든 Hyperliquid SDK API의 완전한 구현
시장 데이터 검색(가격, 주문장, 캔들)
주문 배치 및 관리(시장가, 지정가, 트리거, TWAP)
포지션 관리(레버리지, 마진, 마감)
계좌 정보 및 잔액
자금 조달 비율 정보
이체 및 출금
금고 관리
하위 계정 관리
추천 시스템 통합

기술적 특징

개인 키와 지갑 주소를 모두 사용한 적절한 인증
포괄적인 오류 처리 및 검증
실시간 시장 데이터 접근
주문 추적을 위한 클라이언트 주문 ID(cloid) 지원
테스트넷과 메인넷 모두 지원

필수 조건

Node.js(v14 이상)
Hyperliquid 계정
인증을 위한 Ethereum 개인 키(거래에 필요)
귀하의 지갑 주소(거래에 필요)

설치

지엑스피1

구성

서버는 환경 변수나 구성 파일을 사용하여 구성할 수 있습니다.

환경 변수

HYPERLIQUID_PRIVATE_KEY : 거래를 위해 인증에 필요한 Ethereum 개인 키입니다.
HYPERLIQUID_WALLET_ADDRESS : 귀하의 지갑 주소(거래에 필요)
HYPERLIQUID_VAULT_ADDRESS : 볼트 주소(볼트 작업의 경우 선택 사항)
HYPERLIQUID_TESTNET : 테스트넷을 사용하려면 'true'로 설정하고, 메인넷을 사용하려면 'false'로 설정합니다(기본값: false).
LOG_LEVEL : 로깅 레벨 - 'debug', 'info', 'warn' 또는 'error' (기본값: 'info')

구성 파일

서버와 같은 디렉토리에 다음과 같은 구조의 .hyperliquid-config.json 파일을 만들 수도 있습니다.

{
  "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"]
}

용법

다음을 실행하여 서버를 시작합니다.

npm start

또는 데모 클라이언트를 실행하세요.

npm run demo

사용 가능한 도구

이 서버는 Hyperliquid 거래소와 상호 작용할 수 있는 포괄적인 도구 세트를 제공합니다. 다음은 몇 가지 예입니다.

시장 데이터 도구

getMarketPrice : 지정된 암호화폐의 현재 가격을 가져옵니다.
getOrderBook : 지정된 암호화폐에 대한 현재 주문장을 가져옵니다.
getCandleData : 지정된 암호화폐에 대한 과거 캔들 데이터를 가져옵니다.
getAllMids : 사용 가능한 모든 암호화폐의 모든 중간 가격을 가져옵니다.

계정 정보 도구

getAccountInfo : 사용자의 영구 선물 계좌에 대한 정보를 가져옵니다.
getSpotAccountInfo : 사용자의 스팟 거래 계좌에 대한 정보를 가져옵니다.
getUserOpenOrders : 사용자의 모든 미결 주문을 가져옵니다.
getUserFills : 사용자의 최근 채우기를 가져옵니다.

주문 관리 도구

placeMarketOrder : 지정된 암호화폐에 대한 시장 주문을 넣습니다.
placeLimitOrder : 지정된 암호화폐에 대한 제한 주문을 넣습니다.
placeTriggerOrder : 트리거 주문(손절매 또는 이익실현)을 실행합니다.
placeTwapOrder : TWAP(시간 가중 평균 가격) 주문을 합니다.
cancelOrder : 기존 주문 취소
cancelOrderByCloid : 클라이언트 주문 ID로 주문 취소
cancelAllOrders : 모든 미결 주문 취소
modifyOrder : 기존 주문을 수정합니다.

보안 고려 사항

개인 키 보안 : 이더리움 개인 키는 자금에 대한 완전한 접근 권한을 제공합니다. 공개 저장소에 공유하거나 노출하지 마세요.
먼저 테스트넷을 사용하세요 : 메인넷에서 실제 자금을 사용하기 전에 항상 테스트넷에서 설정을 테스트하세요.
액세스 제한 : 신뢰할 수 있는 AI 도우미 및 애플리케이션으로 MCP 서버에 대한 액세스를 제한합니다.

부인 성명

암호화폐 거래에는 상당한 위험이 따릅니다. 본 도구는 교육 및 정보 제공 목적으로만 제공됩니다. 거래 전에 항상 관련 위험을 숙지하고, 손실을 감당할 수 없는 자금으로 거래하지 마십시오.

특허

MIT

Hyperliquid MCP Server

Integrations