바이낸스 MCP 서버
개요
바이낸스 MCP 서버는 바이낸스 API와 연동되도록 설계된 백엔드 서비스입니다. 바이낸스 거래소와의 원활한 연동을 통해 사용자는 포트폴리오를 확인하고, 토큰을 전환하고, 시장 영향을 최소화하면서 거래를 실행할 수 있습니다. 이 서버는 모델 컨텍스트 프로토콜(MCP) 프레임워크를 활용하여 안전하고 체계적이며 효율적인 거래를 보장합니다.
주요 기능:
- 계정 정보 및 거래를 위해 Binance 거래소 API와 상호 작용합니다.
- 포트폴리오 구성 및 가치 평가 표시
- 시장 영향 완화를 통해 스마트 토큰 변환 실행
- 시장 주문 및 알고리즘 거래 전략 처리
- 실시간 거래 데이터 및 계좌 정보 검색
- 모델 컨텍스트 프로토콜 프레임워크를 사용하여 구조화된 트랜잭션 구현
- Binance 통합을 위한 보안 인증 및 API 키 관리 제공
특징
- [x] Binance API 통합 : 계정 정보 및 거래 작업을 위해 Binance 거래소에 연결
- [x] 포트폴리오 관리 : 자세한 포트폴리오 구성, 시장 가치 및 비율 배분을 확인하세요.
- [x] 포트폴리오 분석 : 시간 경과에 따른 성과를 모니터링하기 위한 선택적 과거 가치 추적
- [x] 스마트 토큰 변환 : 지능형 주문 실행 전략을 통해 토큰 간 변환
- [x] 시장 영향 완화 : 대량 주문에 대해 알고리즘 거래를 자동으로 사용하여 가격 하락을 방지합니다.
- [x] 계정 관리 : 자세한 계정 정보, 잔액 및 거래 내역을 검색합니다.
- [x] 시장 데이터 액세스 : 정보에 입각한 거래 결정을 위해 실시간 주문서 및 시장 데이터에 액세스합니다.
- [x] 주문 실행 : 유연한 수량 사양으로 현물 시장 주문을 실행합니다.
- [ ] 알고리즘 거래 지원 : 시장 영향을 최소화하기 위해 시간 가중 평균 가격(TWAP) 주문을 구현합니다.
- [ ] 자동 거래 : 미리 정의된 전략에 따라 프로그래밍 방식으로 거래를 실행합니다.
- [ ] 보안 인증 : Binance 서비스에 대한 API 키 및 보안 연결을 관리합니다.
- [ ] 포괄적인 오류 처리 : 거래 실패 및 API 문제에 대한 자세한 오류 보고
요구 사항
Binance MCP 서버를 설정하기 전에 다음 사항이 설치되어 있는지 확인하세요.
- Node.js(v16 이상)
- npm 또는 yarn
- 바이낸스 API 키 및 비밀번호(바이낸스 거래소 통합용)
- 유효한 Binance Smart Chain(BSC) 지갑 개인 키(블록체인 거래용)
설치
저장소를 복제하고 종속성을 설치합니다.
지엑스피1
구성
서버를 구성하려면 루트 디렉토리에 .env 파일을 만들고 다음 변수를 지정합니다.
# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here
바이낸스 API 키 생성
바이낸스 API 연동을 사용하기 전에 API 키를 생성해야 합니다. API 키를 통해 여러 프로그래밍 언어를 통해 바이낸스 서버에 연결하고, 바이낸스에서 데이터를 가져오고, 외부 애플리케이션과 상호 작용할 수 있습니다. 지갑 및 거래 데이터를 확인하고, 거래를 하고, 타사 프로그램에서 자금을 입출금할 수 있습니다.
필수 조건:
- 계정을 활성화하려면 Spot Wallet에 원하는 금액을 입금해야 합니다.
- 본인 확인 완료
- 계정에서 2단계 인증(2FA)을 활성화하세요
Binance API 키를 생성하는 단계:
- 바이낸스 계정에 로그인하고 프로필 아이콘을 클릭한 다음 [계정]을 클릭하세요.
- [API 관리]로 이동한 후 [API 생성]을 클릭합니다.
- 원하는 API 키 유형을 선택하세요:
- 시스템 생성 API 키(HMAC 대칭 암호화) - API 키와 비밀 키를 받게 됩니다.
- 자체 생성 API 키(Ed25519 또는 RSA 비대칭 암호화) - API 키를 받게 되지만, 공개-비공개 키 쌍을 직접 만들어야 합니다.
- API 키에 대한 라벨/이름을 입력하세요.
- 2FA 기기와 패스키를 사용하여 확인하세요.
- 이제 API 키가 생성되었습니다.
Binance API에 대한 자세한 내용은 Binance API 문서 를 참조하세요.
Claude Desktop과 통합(여러 MCP 서버용)
Claude Desktop에 MCP 서버를 통합하기 전에 다음 사항이 설치되어 있는지 확인하세요.
모노레포 루트에서 다음 명령을 사용하여 모든 MCP 서버를 빌드합니다.
Claude Desktop 구성
각 MCP 서버는 자체 구성을 갖습니다. 개별 MCP 서버를 통합하려면 다음을 수행하세요.
- MCP 서버 폴더(예:
packages/binance-spot-mcp )로 이동합니다. config.example.json 파일을 엽니다.- 이 파일의 내용을 사용하여 Claude Desktop 구성 내부에 항목을 만듭니다.
Claude Desktop 구성 파일 위치
| 플랫폼 | 길 |
|---|
| 맥OS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| 윈도우 | %APPDATA%\Claude\claude_desktop_config.json |
| 리눅스 | ~/.config/Claude/claude_desktop_config.json |
구성 항목 예시
하나의 MCP 서버( binance-spot-mcp )는 다음과 같습니다.
{
"mcpServers": {
"binance-spot-mcp": {
"command": "node",
"args": ["/Users/Username/Desktop/binance-mpc/packages/packages/binance-spot-mcp/build/index.js"],
"env": {
"BINANCE_API_KEY": "BINANCE_API_KEY",
"BINANCE_API_SECRET": "BINANCE_API_SECRET"
},
"disabled": false,
"autoApprove": []
}
}
}
참고: args 경로를 build/index.js 의 실제 위치로 바꾸고 해당 서버의 config.example.json 에서 env 값을 복사하세요.
새로운 구성을 적용하려면 Claude Desktop을 다시 시작하세요.
사용법(Claude 외의 MCP 호스트 연결용)
사용자의 요구 사항에 따라 MCP 서버를 시작하는 데에는 세 가지 옵션이 있습니다.
옵션 1: 모든 MCP 서버를 빌드한 후 시작합니다.
yarn build # Step 1: Build all packages
yarn start # Step 2: Start all MCP servers concurrently
옵션 2: 한 단계로 모든 MCP 서버 빌드 및 시작
yarn server # This builds and runs all MCP servers in one go
옵션 3: 특정 MCP 서버 실행
다음 명령을 사용하여 개별 서버를 실행하세요.
yarn server:<mcp-server-name>
🔸 예:
yarn server:binance-spot-mcp
기능
바이낸스 API 함수
- 바이낸스 계정 정보 받기 -
binanceAccountInfo잔액, 거래 허가, 계정 상태를 포함하여 바이낸스 계정에 대한 포괄적인 정보를 검색합니다. - 바이낸스 계정 스냅샷 받기 -
binanceAccountSnapshot바이낸스 계정 현황을 스냅샷으로 받아보세요. 현재 BTC 가격 정보도 포함되어 있으며, 지난 30일간의 내역도 포함되어 있습니다. - 바이낸스 주문장 확인 -
binanceOrderBook지정된 거래 쌍에 대한 현재 주문장을 검색하여 최대 50단계까지 가능한 매수 및 매도 주문을 표시합니다. - 현물 시장 주문하기 -
binanceSpotPlaceOrder{
"symbol": "BTCUSDT",
"side": "BUY",
"quantity": 0.001,
// OR
"quoteOrderQty": 100
}
quantity 사용하고, quoteOrderQty 수량을 지정하려면 '견적 주문 수량'을 사용합니다. 소액 주문에 적합합니다. - TWAP 주문하기 -
binanceTimeWeightedAveragePriceFutureAlgo{
"symbol": "BTCUSDT",
"side": "BUY",
"quantity": 1.0,
"duration": 3600
}
모델 컨텍스트 프로토콜(MCP)
모델 컨텍스트 프로토콜(MCP)은 애플리케이션이 AI 모델 및 블록체인 기반 컴퓨팅 시스템과 상호 작용하는 방식을 개선하도록 설계된 개방형 표준입니다. MCP는 자동화된 거래 및 분산 애플리케이션의 효율성을 향상시키는 구조화된 컨텍스트를 구축합니다.
MCP의 이점:
- 표준화 : 애플리케이션 상호작용에 대한 통합된 접근 방식을 정의합니다.
- 효율성 : 계산 오버헤드를 줄이고 거래 속도를 향상시킵니다.
- 상호 운용성 : 다양한 플랫폼과 블록체인 생태계에서의 통합을 지원합니다.
오류 처리
트랜잭션이 실패하면 서버는 자세한 내용이 포함된 오류 메시지를 반환합니다. 콘솔 로그에서 더 자세한 디버깅 정보를 확인하세요. 일반적인 오류 시나리오는 다음과 같습니다.
- 지갑에 자금이 부족합니다
- 잘못된 수신자 주소입니다
- 네트워크 혼잡 또는 RPC 문제
- 바이낸스 API 인증 오류
- 거래 한도 제한
특허
이 프로젝트는 MIT 라이선스에 따라 오픈 소스입니다.
기여, 버그 보고 또는 기능 요청이 있으시면 GitHub 에 이슈를 제출해 주세요.