ethancod1ng/binance-mcp-server

다국어 문서

Claude Code에 Binance 거래소 API 기능을 제공하는 Model Context Protocol (MCP) 서버입니다.

빠르게 시작하려면 종합적인 MCP 사용 튜토리얼을 시청하세요:

npm install -g binance-mcp-server

이 MCP 서버는 MCP를 지원하는 다양한 AI 도구와 함께 사용할 수 있습니다:

MCP 설정 파일에 다음 구성을 추가하세요:

{
"mcpServers": {
"binance": {
...

참고: 개발 및 테스트를 위해 Binance 테스트넷 (testnet)을 사용하려면 BINANCE_TESTNET을 "true"로 설정하세요.

claude mcp add binance --env BINANCE_API_KEY=YOUR_API_KEY --env BINANCE_API_SECRET=YOUR_API_SECRET --env BINANCE_TESTNET=false -- npx -y binance-mcp-server

테스트넷 (Testnet) 용 (개발 시 권장):

• Binance Testnet 방문
• 테스트넷 계정 생성 (실제 인증 불필요)
• 테스트넷 계정의 API 관리 (API Management)로 이동
• 거래 권한이 있는 새로운 API 키 생성
• 참고: 테스트넷은 가상 자금을 사용하므로 테스트하기에 완전히 안전합니다

메인넷 (Mainnet) 용 (운영 환경):

• Binance에서 인증된 계정 생성
• KYC 인증 완료
• 계정 설정의 API 관리 (API Management)로 이동
• 필요한 권한을 가진 새로운 API 키 생성
  ⚠️ 경고: 메인넷은 실제 자금을 사용하므로 매우 주의하십시오!

.env 파일을 생성하세요:

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here
BINANCE_TESTNET=true # 메인넷의 경우 false로 설정 (실제 자금)

get_price

• 거래 쌍의 현재 가격 가져오기
  get_orderbook

• 오더북 (order book) 깊이 데이터 가져오기
  get_klines

• K-line/캔들스틱 (candlestick) 데이터 가져오기
  get_24hr_ticker

• 24시간 가격 통계 가져오기

get_account_info

• 계정 정보 및 잔액 가져오기
  get_open_orders

• 현재 미체결 주문 (open orders) 가져오기
  get_order_history

• 과거 주문 내역 가져오기

place_order

• 새로운 주문 생성 (메인넷 및 테스트넷 모두 지원)
  cancel_order

• 특정 주문 취소 (메인넷 및 테스트넷 모두 지원)
  cancel_all_orders

• 모든 미체결 주문 취소 (메인넷 및 테스트넷 모두 지원)

Claude에게 다음과 같이 요청하세요:

• "Get the current price of Bitcoin" (비트코인의 현재 가격을 가져와줘)
• "Show me the order book for ETHUSDT" (ETHUSDT의 오더북을 보여줘)
• "Check my account balance" (내 계좌 잔고를 확인해줘)
• "Place a limit buy order for 0.001 BTC at $50,000" ($50,000에 0.001 BTC 지정가 매수 주문을 넣어줘)

중요 사항:

• 가상 자금으로 안전하게 테스트하려면 BINANCE_TESTNET=true로 설정하세요.
• 실제 자금으로 메인넷 거래를 하려면 BINANCE_TESTNET=false로 설정하거나 생략하세요. 메인넷 거래 시 주문을 실행하기 전에 경고 메시지가 표시됩니다.

npm run build # TypeScript 컴파일
npm run dev # 개발 모드
npm run lint # 린팅(linting) 실행