Binance MCP Server

Model Context Protocol 기반의 Binance USDT-M 선물 MCP 서버로, AI 어시스턴트에게 61개의 MCP 도구를 제공하여 시세 데이터, 기술 지표, 리스크 분석과 선물 거래를 다룹니다.

MCP server v2 SDK와 바이낸스 공식 SDK(@binance/derivatives-trading-usds-futures)를 기반으로 구축되었으며, 모든 수치는 거래소 정밀도 규칙에 따라 자동으로 정규화됩니다. 2단계 시세 캐시, -1007 타임아웃 멱등 복구, 클록 편차 감지도 포함합니다.

빠른 시작

설정 없이 체험하기（분석 전용, 거래 제외）

npx @iuk-ink/binance-mcp-server

API 키가 필요 없으며, 기본적으로 테스트넷에 연결되어 시세·지표·위험 분석 도구를 바로 사용할 수 있습니다.

MCP Client 설정

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["-y", "@iuk-ink/binance-mcp-server"],
      "env": {
        "BINANCE_TESTNET": "true"
      }
    }
  }
}

거래 기능이 필요하면 BINANCE_API_KEY와 BINANCE_API_CECRET을 추가하세요.

환경 변수

| 변수 | 필수 | 기본 | 설명 | | --------------------- | :-: -------------------- | --------------------------------------- | | BINANCE_TESTNET |:no |. true | 테스트넷(가상 자금) / 메인| | BINANCE_USE_DEMO |:no | false | 데모 거래 환경 (메인 자격명과 공용) | | BINANCE_BASE_URL |:no | — | custom REST 엔드포인트 (최우선 known) | | BINANCE_API_KEY |:no | — | 미입력시 거래도어 미do not 등록 | | BINANCE_API_SECRET |:no | —
| BINANCE_ProXY_URL |:no | — | HTTP/HTTPS 프록시 주소 | | BINANCE_TIMEOUT | No | 10000 | 요청 타임아웃 (밀리초) | | BINANCE_RETRIES | No | 3 | 네트워크 재시도 횟수 | | BINANCE_BACKOFF | No | 1000 | 재시도 백오프 기본 (밀리초) | | BINANCE_RECV_WINDOW| No | 5000 | 서명 시간 윈도우 (밀리초) | | MCP_TOOL_DOMAINS |:no_| 전 | 도구 필터, 반개 구분: market,trading,indicator,analysis | | MCP_SERVER_NAME |:no__ | binance-mcp-server | MCP service name | | LOG_LEVEEL |_te_none | info4 | debug / info / warn / error |

Related MCP server: Binance MCP Server

도구 목록 (61개, 메인넷)

테스트넷에서는 5개(57 presence)로, 감정 지표 엔드포인트 4개는 메인넷에서만 사용할 수 있어 등록되지 않습니다.

시장 데이터 (18)

기술 지표 (19)

직전 연결 설계: K라인 조회 → 지표 계산을 한 번에 완료하므로 market_klines를 먼저 호출할 필요가 없습니다.

리스크 분석 (3)

선물 거래 (21개, API 키 필요)

주문 시 우선/ 수량 정결도가 내림 처리되고(tickSize / stepSize 단위), 최소 명의 가치 검증은 자동으로 выполняется. -1007 세그멘트 티엠아웃 발생 시에도 멱등 주문번호로 체결 상태를 확인한 후 재시도 여부를 결정합니다.

2.x에서 3.x로의 마이그레이션

파적 Change

• MCP SDK: @modelcontextprotocol/sdk@1 → @modelcontextprotocol/server@2 (공식 패키지 명 변경)

• Binance 연동: 커니티 패키지 binance@4 → 공식 @binance/derivatives-rading-usds-futures@4

• Node.js: >=18 → >=20

• 代理 변수: HTTP_ProXY → BINANCE_ProXY_URL

• 도구 집합 76→61: 통계 보조 domain(평균/극값/사분위수 등 10개)과 지표 독립형/신호형의 복 중복 변ना 제거; _direct 접미사 도구는 접미사 없는 직결 방식으로 변경(rsi_direct → indicator_rsi), 리스크 지표명 변경 (risk_* → analysis_*)

• 도구명 접두사: 전체 도구에 도메인 접두사(market_ / indicator_ / analysis_ / trading_)가 붙어, AI 클라언트의 기존 프롬프트와 워크플로는 새 이름에 맞게 적 value해야 합니다.

추가된 기능

• market_overview 원스톱 스냅샷(단일 호출로 시세·지표·자금·호가 집계)

• MCP_TOOL_DOMAINS 도구 도메인 필터, BINANCE_USE_DEMO / BINANCE_BASE_URL 환경 전환

• 2단계 캐قی (exchangeInfo 5분 + K라인 3초, 동시 요청 중 중보 방지)

• -1005 주문 타임아웃 멱등 복구, 시버 시작 시 클록 편차 검지

• 주문 정수 자동 정리 + 최소 명의 가치 사전 검사

• 파라미터 검사를 공식 제약과 완전히 일위 (clientOrderId 문자집합、GTD 상한、추적 손절 하차율 0.1~10 등)

AI 사용 가이드 (Skill)

리포지지에는 skills/binance-trader/SKILL.md가 포함되어 있습니다——AI 어시스턴트를 위한 사용 매뉴얼이며, 도구 선택 결정부터 도구 간 워크플로、거래 안전 규율、오류 복구 시나리오까지 다룹니다. Skill 지원 가능한 클라이언트(Claude Code / Trae 등)에서는 바로 연결하여 AI가 "도구를 쓸 줄 안다"에서 "도구를 잘 쓴다"로 발전합니다.

로컬 개발

git clone https://github.com/iuk-ink/binance-mcp-server
cd binance-mcp-server
npm install

Command

라이선스

MIT