CCXT MCP 서버

Name: CCXT MCP Server
Author: lazy-dinosaur

npm 버전 npm 다운로드 GitHub 별점 라이센스: MIT

CCXT MCP 서버는 AI 모델이 모델 컨텍스트 프로토콜(MCP)을 통해 암호화폐 거래소 API와 상호 작용할 수 있도록 지원하는 서버입니다. 이 서버는 CCXT 라이브러리를 사용하여 100개 이상의 암호화폐 거래소와 거래 기능에 대한 액세스를 제공합니다.

🚀 빠른 시작

지엑스피1

Related MCP server: EVM MCP Server

설치 및 사용

글로벌 설치

# Install the package globally npm install -g @lazydino/ccxt-mcp

npx로 실행

설치 없이 바로 실행할 수 있습니다.

# Using default settings npx @lazydino/ccxt-mcp # Using custom configuration file npx @lazydino/ccxt-mcp --config /path/to/config.json

도움말 보기:

npx @lazydino/ccxt-mcp --help

구성

Claude Desktop에 MCP 서버 등록

Claude 데스크톱 설정 열기 :
- Claude Desktop 앱의 설정 메뉴로 이동하세요
- "MCP 서버" 섹션을 찾으세요
새로운 MCP 서버 추가 :
- "서버 추가" 버튼을 클릭하세요
- 서버 이름: ccxt-mcp
- 명령어: npx @lazydino/ccxt-mcp
- 추가 인수(선택 사항): --config /path/to/config.json
서버를 저장하고 테스트하세요 .
- 설정을 저장하세요
- "연결 테스트" 버튼을 눌러 연결을 테스트하세요.

구성 방법 - 두 가지 옵션

옵션 1: Claude 데스크톱 설정에 계정 정보를 직접 포함(기본 방법)

이 방법을 사용하면 CCXT 계정 정보가 Claude Desktop 설정 파일(claude_desktop_config.json)에 직접 포함됩니다.

{ "mcpServers": { "ccxt-mcp": { "command": "npx", "args": ["-y", "@lazydino/ccxt-mcp"], "accounts": [ { "name": "bybit_main", "exchangeId": "bybit", "apiKey": "YOUR_API_KEY", "secret": "YOUR_SECRET_KEY", "defaultType": "spot" }, { "name": "bybit_futures", "exchangeId": "bybit", "apiKey": "YOUR_API_KEY", "secret": "YOUR_SECRET_KEY", "defaultType": "swap" } ] } } }

이 방법을 사용하면 별도의 구성 파일이 필요하지 않습니다. 모든 설정은 Claude Desktop 구성 파일에 통합되어 있습니다.

옵션 2: 별도의 구성 파일 사용(고급 방법)

계정 정보를 별도의 구성 파일에 분리하려면 다음과 같이 설정하세요.

별도의 구성 파일을 만듭니다 (예: ccxt-accounts.json ):

{ "accounts": [ { "name": "bybit_main", "exchangeId": "bybit", "apiKey": "YOUR_API_KEY", "secret": "YOUR_SECRET_KEY", "defaultType": "spot" }, { "name": "bybit_futures", "exchangeId": "bybit", "apiKey": "YOUR_API_KEY", "secret": "YOUR_SECRET_KEY", "defaultType": "swap" } ] }

Claude Desktop 설정에서 구성 파일 경로를 지정하세요 .

{ "mcpServers": { "ccxt-mcp": { "command": "npx", "args": [ "-y", "@lazydino/ccxt-mcp", "--config", "/path/to/ccxt-accounts.json" ] } } }

별도의 구성 파일을 사용하는 이유 :
재귀 참조 문제를 방지합니다.
API 키와 같은 민감한 정보를 분리합니다.
더욱 쉬운 다중 환경 구성(개발, 테스트, 프로덕션)
개선된 구성 파일 버전 제어

주요 특징

시장 정보 검색 :
- 거래소 목록
- 거래소별 시장 정보 보기
- 특정 심볼에 대한 가격 정보를 얻으세요
- 특정 심볼에 대한 주문장 정보 보기
- 과거 OHLCV 데이터 검색
거래 기능 :
- 시장가/지정가 주문 생성
- 주문 취소 및 상태 확인
- 계좌 잔액 보기
- 거래 내역 확인
거래 분석 :
- 일일/주간/월간 성과 분석
- 승률 계산(지난 7일, 30일, 전체 기간)
- 평균 이익/손실 비율(R-배수)
- 최대 연속 손실/이익 시리즈 분석
- 자산 변동 추적
- 포괄적인 성과 지표
- 거래 패턴 인식
- 기간 기반 수익률 계산
직위 관리 :
- 자본 비율 거래(예: 계정 자본의 5%로 진입)
- 선물시장 레버리지 설정(1~100배)
- 동적 포지션 크기 조정(변동성 기반)
- 분할 매수/매도 전략 구현
위험 관리 :
- 기술 지표 기반 손절 설정(예: 5분 차트에서 10개 캔들 중 가장 낮은 지점)
- 변동성 기반 손절매/이익 실현(ATR 배수)
- 최대 허용 손실 한도(일일/주간)
- 동적 이익 실현 설정(추적 이익)

작동 원리

User <--> AI Model(Claude/GPT) <--> MCP Protocol <--> CCXT MCP Server <--> Cryptocurrency Exchange API

사용자 : "비트코인 가격을 알려주세요" 또는 "바이낸스 계정으로 이더리움을 구매하세요"와 같은 요청
AI 모델 : 사용자 요청을 이해하고 사용할 MCP 도구/리소스를 결정합니다.
MCP 프로토콜 : AI와 CCXT MCP 서버 간의 표준화된 통신
CCXT MCP 서버 : CCXT 라이브러리를 사용하여 암호화폐 거래소 API와 통신합니다.
거래소 API : 실제 데이터 제공 및 거래 주문 실행

AI 모델과 함께 사용

Claude Desktop에 등록하면 AI 모델에 대해 다음과 같은 유형의 요청을 할 수 있습니다.

주의 사항 및 권장 사항

AI 모델을 사용할 때는 다음 주의 사항을 고려하고 아래 프롬프트를 사용하여 효과적인 거래를 진행하세요.

Your goal is to execute trades using the ccxt tools as much as possible Cautions: - Accurately identify whether it's a futures market or spot market before proceeding with trades - If there's no instruction about percentage of capital or amount to use, always calculate and execute trades using the entire available capital

참고사항:

AI 모델은 때때로 선물 거래와 현물 거래를 혼동합니다.
거래 자본 규모에 대한 명확한 지침이 없으면 AI가 혼란스러워질 수 있습니다.
위의 프롬프트를 사용하면 거래 의도를 명확하게 전달하는 데 도움이 됩니다.

기본 쿼리 예제

Check and compare the current Bitcoin price on binance and coinbase.

고급 거래 쿼리 예시

직위 관리

Open a long position on BTC/USDT futures market in my Bybit account (bybit_futures) with 5% of capital using 10x leverage. Enter based on moving average crossover strategy and set stop loss at the lowest point among the 12 most recent 5-minute candles.

성과 분석

Analyze my Binance account (bybit_main) trading records for the last 7 days and show me the win rate, average profit, and maximum consecutive losses.

자세한 거래 분석

Analyze my trading performance on the bybit_futures account for BTC/USDT over the last 30 days. Calculate win rate, profit factor, and identify any patterns in my winning trades.

Show me the monthly returns for my bybit_main account over the past 90 days and identify my best and worst trading months.

Analyze my consecutive wins and losses on my bybit_futures account and tell me if I have any psychological patterns affecting my trading after losses.

개발

소스에서 빌드

# Clone repository git clone https://github.com/lazy-dinosaur/ccxt-mcp.git # Navigate to project directory cd ccxt-mcp # Install dependencies npm install # Build npm run build

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

📄 라이센스

MIT 라이선스에 따라 배포됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

❤️ 지원

이 프로젝트가 유용하다고 생각되시면 GitHub에서 ⭐️를 눌러주세요!

CCXT MCP Server