MCP 문서 관리

메뉴

Bsc-mcp

Bsc-mcp

Bsc-mcp는 AI와 BNB Chain(이전의 Binance Smart Chain) 간의 브리지 역할을 하는 MCP 서버입니다. 이 서버는 블록체인 데이터 검색, 지갑 관리, 토큰 전송, 스마트 계약 상호작용 등 다양한 기능을 통해 Claude가 BNB Chain 생태계와 원활하게 상호작용할 수 있도록 지원합니다.

특징

  • BNB 및 BEP-20 토큰 전송: 토큰 전송 기능을 통한 간편한 자산 이동
  • 지갑 관리: 계정 생성, 가져오기 및 관리 기능
  • 스마트 계약 상호작용: 스마트 계약 배포 및 호출 지원
  • 토큰 스왑: PancakeSwap을 통한 토큰 교환 기능
  • 블록체인 데이터 조회: 계정 잔액, 트랜잭션 이력, 블록 정보 등 조회
  • 토큰 정보 조회: BEP-20 토큰 정보 및 가격 데이터 액세스
  • DeFi 프로토콜 통합: PancakeSwap, Venus 등 주요 BNB Chain DeFi 프로토콜 지원
  • NFT 관리: NFT 조회, 전송 및 상호작용 기능

API

도구

계정 및 지갑

  • get_account_info: 계정 정보 조회
  • 입력: 지갑 주소
  • 출력: BNB 잔액, BEP-20 토큰 잔액, 트랜잭션 카운트 등

  • create_wallet: 새 지갑 생성

  • 입력: 없음
  • 출력: 지갑 주소, 프라이빗 키, 니모닉

토큰 및 트랜잭션

  • transfer_bnb: BNB 전송
  • 입력: 수신자 주소, 금액, 가스 설정(선택적)
  • 출력: 트랜잭션 해시 및 상태

  • transfer_token: BEP-20 토큰 전송

  • 입력: 수신자 주소, 토큰 주소, 금액, 가스 설정(선택적)
  • 출력: 트랜잭션 해시 및 상태

  • get_token_info: BEP-20 토큰 정보 조회

  • 입력: 토큰 주소
  • 출력: 이름, 심볼, 소수점, 총 공급량 등

스마트 계약

  • deploy_contract: 스마트 계약 배포
  • 입력: 계약 바이트코드, 생성자 인수, 가스 설정(선택적)
  • 출력: 계약 주소 및 배포 트랜잭션 정보

  • call_contract: 스마트 계약 함수 호출

  • 입력: 계약 주소, 함수 이름, 함수 인수, ABI, 가스 설정(선택적)
  • 출력: 함수 호출 결과

DeFi 및 스왑

  • swap_tokens: PancakeSwap을 통한 토큰 스왑
  • 입력: 입력 토큰 주소, 출력 토큰 주소, 금액, 슬리피지(선택적)
  • 출력: 스왑 트랜잭션 정보

  • get_token_price: 토큰 가격 조회

  • 입력: 토큰 주소
  • 출력: BNB 및 USD 기준 토큰 가격

블록체인 데이터

  • get_transaction: 트랜잭션 정보 조회
  • 입력: 트랜잭션 해시
  • 출력: 트랜잭션 세부 정보

  • get_block: 블록 정보 조회

  • 입력: 블록 번호 또는 해시
  • 출력: 블록 세부 정보

사용 방법

설치

# npm을 통한 설치
npm install -g bsc-mcp

# 또는 저장소 클론
git clone https://github.com/TermiX-official/bsc-mcp.git
cd bsc-mcp
npm install

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정 파일에 추가할 수 있습니다:

{
  "mcpServers": {
    "bsc-mcp": {
      "command": "npx",
      "args": ["-y", "bsc-mcp"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "RPC_URL": "https://bsc-dataseed.binance.org/",
        "CHAIN_ID": "56"
      }
    }
  }
}

테스트넷을 사용하려면 다음 환경 변수를 설정합니다:

"env": {
  "PRIVATE_KEY": "your_private_key_here",
  "RPC_URL": "https://data-seed-prebsc-1-s1.binance.org:8545/",
  "CHAIN_ID": "97"
}

사용 예시

// BNB 전송
const result = await transfer_bnb({
  to: "0x1234567890abcdef1234567890abcdef12345678",
  amount: "0.1"
});
console.log(`트랜잭션 해시: ${result.transactionHash}`);

// BEP-20 토큰 전송
const tokenResult = await transfer_token({
  to: "0x1234567890abcdef1234567890abcdef12345678",
  tokenAddress: "0xabcdef1234567890abcdef1234567890abcdef12",
  amount: "10"
});

// 토큰 스왑 (PancakeSwap)
const swapResult = await swap_tokens({
  tokenIn: "0xabcdef1234567890abcdef1234567890abcdef12",
  tokenOut: "0x1234567890abcdef1234567890abcdef12345678",
  amount: "5",
  slippage: 0.5
});

한계 및 고려 사항

  • 프라이빗 키 보안: 환경 변수를 통해 프라이빗 키를 제공해야 하므로 보안에 주의해야 합니다.
  • RPC 노드 의존성: 선택한 RPC 노드의 안정성에 따라 성능이 달라질 수 있습니다.
  • 가스비 고려: BNB Chain의 가스비가 변동될 수 있으므로 트랜잭션 실행 시 적절한 가스비 설정이 필요합니다.
  • API 속도 제한: 과도한 요청은 RPC 노드 제공자의 속도 제한에 걸릴 수 있습니다.
  • 네트워크 선택: 메인넷과 테스트넷 사이를 전환할 때 적절한 환경 변수 설정이 필요합니다.

연결된 구성 요소

  • EVM MCP Server - 더 광범위한 EVM 호환 블록체인 지원을 제공하는 서버
  • GOAT - 다양한 블록체인에서 온체인 작업을 실행하는 도구
  • crypto-feargreed-mcp - 암호화폐 시장 심리 분석 도구