Skip to main content
Glama
Sign In
enesjakozh

bnbchain-mcp

Official
by bnb-chain
npmGitHub
TypeScript
MIT License
353
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides tools for interacting with BNB Chain through natural language, including blockchain queries, smart contract interaction, wallet management, token operations, and NFT management.

  • Supports local development with Bun, providing setup instructions and development scripts for running and testing the MCP server.

  • Supports interaction with Ethereum and other EVM-compatible networks, enabling blockchain development, smart contract interaction, and network management through AI-powered interfaces.

BNBChain MCP(모델 컨텍스트 프로토콜)

자연어 처리와 AI 지원을 통해 BNB 체인 및 기타 EVM 호환 네트워크와 상호 작용할 수 있는 강력한 툴킷입니다.

설명

BNBChain MCP는 AI 기반 인터페이스를 통해 블록체인 네트워크와의 원활한 상호작용을 지원하는 모델 컨텍스트 프로토콜(MCP) 구현입니다. 블록체인 개발, 스마트 계약 상호작용 및 네트워크 관리를 위한 포괄적인 도구와 리소스 세트를 제공합니다.

핵심 모듈

이 프로젝트는 몇 가지 핵심 모듈로 구성됩니다.

  • 블록 : 블록체인 블록을 쿼리하고 관리합니다.
  • 계약 : 스마트 계약과 상호 작용
  • 네트워크 : 네트워크 정보 및 관리
  • NFT : NFT(ERC721/ERC1155) 운영
  • 토큰 : 토큰(ERC20) 작업
  • 거래 : 거래 관리
  • 지갑 : 지갑 운영 및 관리
  • 공통 : 공유 유틸리티 및 유형
  • 곧 추가 기능이 출시됩니다(Greenfield, Swap, Bridge 등)

커서와의 통합

Cursor에서 MCP 서버에 연결하려면:

  1. 커서를 열고 설정(오른쪽 상단의 기어 아이콘)으로 이동하세요.
  2. 왼쪽 사이드바에서 "MCP"를 클릭하세요
  3. "새로운 글로벌 MCP 서버 추가"를 클릭하세요.
  4. 다음 세부 정보를 입력하세요.

기본 모드

지엑스피1

SSE 모드

{ "mcpServers": { "bnbchain-mcp": { "command": "npx", "args": ["-y", "@bnb-chain/mcp@latest", "--sse"], "env": { "PRIVATE_KEY": "your_private_key_here. (optinal)" } } } }

Claude Desktop과 통합

Claude Desktop에서 MCP 서버에 연결하려면:

  1. Claude Desktop을 열고 설정으로 이동하세요.
  2. 왼쪽 사이드바에서 "개발자"를 클릭하세요
  3. "구성 편집" 버튼을 클릭하세요
  4. claude_desktop_config.json 파일에 다음 구성을 추가합니다.
{ "mcpServers": { "bnbchain-mcp": { "command": "npx", "args": ["-y", "@bnb-chain/mcp@latest"], "env": { "PRIVATE_KEY": "your_private_key_here" } } } }
  1. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

연결되면 Claude Desktop 대화에서 모든 MCP 프롬프트와 도구를 직접 사용할 수 있습니다. 예:

  • "이 주소를 분석하세요: 0x123..."
  • "가스에 대한 EVM 개념을 설명하세요"
  • "BSC의 최신 블록을 확인하세요"

다른 클라이언트와의 통합

BNBChain MCP를 귀하의 클라이언트에 통합하려면 자세한 정보와 참조 구현을 보려면 예제 디렉토리를 확인하세요.

다음 예는 다음을 보여줍니다.

  • MCP 클라이언트를 설정하는 방법
  • 인증 및 구성
  • 블록체인 네트워크와 상호 작용하기 위한 API 호출 만들기
  • 응답 및 오류 처리
  • 통합을 위한 모범 사례

지역 개발

필수 조건

빠른 시작

  1. 저장소를 복제합니다.
git clone https://github.com/bnb-chain/bnbchain-mcp.git cd bnbchain-mcp
  1. 환경 변수 설정:
cp .env.example .env

구성에 맞게 .env 파일을 편집합니다.

  • PRIVATE_KEY : 지갑 개인 키(거래 작업에 필요)
  • LOG_LEVEL : 로깅 레벨 설정(DEBUG, INFO, WARN, ERROR)
  • PORT : 서버 포트 번호 (기본값: 3001)
  1. 종속성을 설치하고 개발 서버를 시작합니다.
# Install project dependencies bun install # Start the development server bun dev:sse

MCP 클라이언트로 테스트

다음 템플릿을 사용하여 MCP 클라이언트에서 로컬 서버를 구성하세요.

{ "mcpServers": { "bnbchain-mcp": { "url": "http://localhost:3001/sse", "env": { "PRIVATE_KEY": "your_private_key_here" } } } }
웹 UI로 테스트하기

테스트를 위해 @modelcontextprotocol/inspector 사용합니다. 테스트 UI를 실행합니다.

bun run test
사용 가능한 스크립트
  • bun dev:sse : 핫 리로드로 개발 서버 시작
  • bun build : 프로젝트를 빌드합니다
  • bun test : 테스트 모음 실행

사용 가능한 프롬프트 및 도구

프롬프트

이름설명
분석_블록블록을 분석하고 해당 내용에 대한 자세한 정보를 제공합니다.
거래 분석특정 거래 분석
분석_주소EVM 주소 분석
계약과 상호 작용스마트 계약 상호 작용에 대한 지침을 받으세요
설명_evm_개념EVM 개념에 대한 설명을 받으세요
네트워크 비교다양한 EVM 호환 네트워크 비교
분석_토큰ERC20 또는 NFT 토큰 분석

도구

이름설명
해시로 블록 가져오기해시로 블록 가져오기
번호로 블록 가져오기숫자로 블록을 얻으세요
최신 블록 가져오기최신 블록을 받으세요
거래 받기해시를 통해 특정 거래에 대한 자세한 정보를 얻으세요
거래 영수증 받기해시로 거래 영수증을 받으세요
가스 추정거래에 대한 가스 비용을 추정하세요
전송_네이티브_토큰네이티브 토큰(BNB, ETH, MATIC 등)을 주소로 전송합니다.
토큰 지출 승인ERC20 토큰을 사용할 다른 주소를 승인하세요
전송_nft한 주소에서 다른 주소로 NFT(ERC721 토큰) 전송
전송_erc1155ERC1155 토큰을 다른 주소로 전송하세요
전송_erc20ERC20 토큰을 주소로 전송
개인 키에서 주소 가져오기개인 키에서 파생된 EVM 주소를 가져옵니다.
get_chain_info특정 네트워크에 대한 체인 정보 가져오기
지원되는 네트워크를 얻으세요지원되는 네트워크 목록 가져오기
해결_ensENS 이름을 EVM 주소로 확인
is_contract주소가 스마트 계약인지 아니면 외부 소유 계정(EOA)인지 확인하세요.
읽기_계약뷰/순수 함수를 호출하여 스마트 계약에서 데이터를 읽습니다.
쓰기_계약상태 변경 함수를 호출하여 스마트 계약에 데이터를 씁니다.
get_erc20_토큰_정보ERC20 토큰 정보 받기
네이티브_밸런스를 얻으세요주소에 대한 네이티브 토큰 잔액을 가져옵니다.
get_erc20_balance주소에 대한 ERC20 토큰 잔액을 받으세요
get_nft_info특정 NFT에 대한 자세한 정보를 얻으세요
NFT 소유권 확인주소가 특정 NFT를 소유하고 있는지 확인하세요
get_erc1155_토큰_uriERC1155 토큰의 메타데이터 URI 가져오기
get_nft_balance특정 컬렉션에서 주소가 소유한 NFT의 총 수를 가져옵니다.
get_erc1155_잔액주소가 소유한 특정 ERC1155 토큰 ID의 잔액을 가져옵니다.

지원되는 네트워크

BSC, opBNB, Ethereum 및 기타 주요 EVM 호환 네트워크를 지원합니다. 자세한 내용은 src/evm/chains.ts 참조하세요.

기여하다

BNBChain MCP에 대한 여러분의 기여를 환영합니다! 참여 방법은 다음과 같습니다.

  1. 저장소를 포크하세요
  2. 기능 브랜치 생성
  3. 변경 사항을 커밋하세요
  4. 지점으로 푸시하세요
  5. 풀 리퀘스트 만들기

귀하의 코드가 당사의 코딩 표준을 따르고 적절한 테스트를 포함하고 있는지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

참고문헌 및 감사의 글

이 프로젝트는 다음의 오픈소스 프로젝트를 기반으로 하고 영감을 받았습니다.

우리는 블록체인 생태계에 기여한 원저자들에게 감사를 표합니다.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

bnbchain-mcp

  1. Description
    1. Core Modules
      1. Integration with Cursor
        1. Integration with Claude Desktop
          1. Integration with Other Clients
            1. Local Development
              1. Prerequisites
              2. Quick Start
              3. Testing with MCP Clients
            2. Available Prompts and Tools
              1. Prompts
              2. Tools
            3. Supported Networks
              1. Contributing
                1. License
                  1. References and Acknowledgments

                    Related Resources

                    Related MCP Servers

                    View all related MCP servers

                    ID: t6zbvd82tr