OKX MCP 서버

OKX 거래소에서 실시간 암호화폐 가격 데이터를 제공하는 모델 컨텍스트 프로토콜 서버입니다.

특징

이 MCP 서버는 OKX API에 연결하여 간단한 도구 인터페이스를 통해 암호화폐 가격 정보를 제공합니다. OKX API를 통한 포괄적인 오류 처리, 요청 로깅 및 속도 제한 기능을 포함합니다.

도구

get_candlesticks

OKX의 모든 악기에 대한 과거 캔들스틱(OHLCV) 데이터를 검색합니다.

• 입력 :
  • instrument : 문자열(필수) - 악기 ID(예: "BTC-USDT")
  • bar : 문자열(선택 사항) - 시간 간격(예: "1m", "5m", "1H", "1D"), 기본값은 "1m"입니다.
  • limit : Number (선택 사항) - 반환할 캔들스틱 수(최대 100개), 기본값 100개
• 출력 : JSON 객체 배열, 각각 포함:
  • timestamp : 캔들스틱의 ISO 타임스탬프
  • open : 시작가
  • high : 가장 높은 가격
  • low : 가장 낮은 가격
  • close : 종가
  • volume : 거래량
  • volumeCurrency : 통화로 환산한 볼륨

사용 예:

지엑스피1

get_price

OKX에 상장된 모든 상품의 최신 가격과 24시간 시장 데이터를 가져옵니다.

• 입력 :
  • instrument : 문자열(필수) - 악기 ID(예: "BTC-USDT")
• 출력 : 다음을 포함하는 JSON 객체:
  • instrument : 요청된 악기 ID
  • lastPrice : 최신 거래 가격
  • bid : 현재 최고 입찰가
  • ask : 현재 가장 좋은 매도 가격
  • high24h : 24시간 최고가
  • low24h : 24시간 저렴한 가격
  • volume24h : 24시간 거래량
  • timestamp : 데이터의 ISO 타임스탬프

사용 예:

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude Desktop 또는 VSCode와 함께 사용하려면 MCP 설정에 서버 구성을 추가하세요.

macOS(VSCode):

macOS(클로드 데스크톱):

윈도우(VSCode):

Windows(Claude Desktop):

구성:

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

• 네트워크 오류는 캡처되어 컨텍스트와 함께 반환됩니다.
• 잘못된 기기 ID는 적절한 오류 메시지를 반환합니다.
• API 속도 제한은 Axios 시간 초과 구성을 통해 준수됩니다.
• 모든 오류는 디버깅 목적으로 기록됩니다.