exchange-data-mcp

암호화폐 거래소를 위한 읽기 전용 마켓 데이터 MCP 서버로, 공개 엔드포인트만 사용하며 API 키나 계정이 필요 없습니다. Binance, KuCoin, Coinbase를 하나의 형태로 정규화하여 LLM 컨텍스트용으로 직렬화합니다.

에이전트 클라이언트용 MCP 서버로 작동하거나, 의존성이 전혀 없는 일반 Python 라이브러리로 작동합니다.

존재 이유

시장에서 작동하는 에이전트는 주문장(오더북), 체결 내역, 캔들이 필요합니다. 기존 옵션들은 모델에게 원시 거래소 JSON을 그대로 전달합니다. 원시 페이로드는 모델이 읽지 않는 추가적인 쓸모없는 데이터를 자주 포함하는데, 이 옵션은 그렇지 않으며 게다가 거래소 간 정보를 통합합니다. 이 패키지는 각양각색의 형식을 한 번 정규화한 후 더 쉽게 직렬화합니다.

Related MCP server: Binance Cryptocurrency MCP

주요 특징 :

• 심볼 방언. KuCoin과 Coinbase의 BTC-USDT, Binance의 BTCUSDT가 하나의 표준 형식(BASE-QUOTE)으로 통합됩니다.

• 타임스탬프 단위는 거래소와 엔드포인트마다 다릅니다. Binance는 밀리초, KuCoin 통계와 오더북은 밀리초, KuCoin 체결 내역은 나노초, KuCoin과 Coinbase의 캔들은 초, Coinbase 티커는 ISO 문자열입니다. 모든 모델은 epoch 이후 밀리초 단위로 출력됩니다.

• Coinbase 캔들 행은 [time, low, high, open, close, volume] 순서이며 최신이 먼저입니다. 이것이 문서화된 열 순서입니다. KuCoin 캔들은 대신 [time, open, close, high, low, ...]를 사용합니다. 테스트로 위치 매핑을 하거나 파서가 캔들을 뒤집습니다.

• 속도 제한은 IP별로 적용되며 에이전트 도구는 일시에 몰려서 동작합니다. 캐시는 엔드포인트별 TTL을 유지하고 동시에 발생하는 캐시 미스를 하나의 요청으로 합칩니다(single-flight). 따라서 같은 초에 다섯 개의 도구가 같은 오더북을 읽어도 HTTP 호출은 한 번만 발생합니다. 실패는 캐시되지 않으며, 리더가 오류를 일으킨 호출자는 즉시 재시도합니다.

• 스프레드 계산은 처음부터 끝까지 Decimal로 수행됩니다.

• 슬림한 직렬화기는 정확한 소수 문자열을 짧은 키 아래에 유지합니다. 기록된 픽스처로 측정한 결과, 24시간 티커는 원시 봉투 605바이트에서 207바이트(34%)로 줄어듭니다. 이미 간결한 오더북 스냅샷에서는 크기가 거의 동일하며, 핵심 이점은 세 거래소에서 하나의 스키마를 사용한다는 것입니다.

사용법

라이브러리로 사용(의존성 없음):

from exchange_data_mcp import MarketDataService
from exchange_data_mcp.transport import urllib_fetcher

svc = MarketDataService(urllib_fetcher())
svc.ticker("kucoin", "BTC-USDT")
svc.compare("BTC-USDT")   # same pair on every venue, executable spread from top of book

MCP 서버로 사용:

pip install -e ".[mcp]"
python -m exchange_data_mcp.server

노출되는 도구: get_ticker, get_orderbook, get_recent_trades, get_candles, compare_price.

오류는 유형별로 분류됩니다: 재시도 가능(RateLimited는 retry_after를 포함, ExchangeUnavailable), 입력 수정 필요(SymbolNotFound, UnsupportedRequest), 또는 거래소 측 변경(BadResponse)입니다.

테스트

37개의 테스트로, 기록된 픽스처를 대상으로 완전히 오프라인에서 실행됩니다:

python3 -m unittest discover -s tests -t .

상태

포트폴리오용입니다. TTL 캐시를 사용하는 REST입니다. 동일한 엔지니어링의 실시간 10ms 스트리밍 측면은 kucoin-fast-stream을 참조하세요.