BSC Blockchain

BNBChain MCP is a plug-and-play tool server that supports functions such as BNB transfers, BEP-20 token operations, and smart contract interactions on Binance Smart Chain, and integrates Claude Desktop and developer tools.

Developer tools Finance #BSC tools #Smart contracts #Token operations #MCP protocol Local .TypeScript

rating : 2.5 points

downloads : 86

update time : 2025-04-28

Built-in wallet systemIntegrates a secure wallet function, supporting token management and transaction operations.

Multi-chain compatibilitySupports multiple blockchain networks including BSC, Binance Chain, and other EVM-compatible chains.

AI agent integrationAn interaction interface designed specifically for AI agents to simplify the smart contract operation process.

Install the MCP tool server

Install the MCP tool server using npm.

Initialize the configuration

Create and edit the configuration file, setting the network environment and other parameters.

Start the service

Start the tool server using the MCP service command.

How can I ensure the security of my wallet?

Does it support MetaMask integration?

Official documentation

Detailed technical documentation and source code for the MCP tool server.

Binance Smart Chain Developer Portal

Official development resources for Binance Smart Chain.

🚀 BSC MCP Tool Server – One-Stop Solution for Binance Smart Chain (MCP + CLI Support)

This is a plug-and-play MCP tool server designed for Claude Desktop, AI agents, and developers. It supports the following functions on the Binance Smart Chain (BSC): sending BNB, converting BEP-20 tokens, deploying tokens, and interacting with smart contracts.

🚀 Quick Start

The BSC MCP Tool Server is a versatile solution for operations on the Binance Smart Chain. It offers a range of features and seamless integration with various platforms.

✨ Features

🔐 Secure token and native token transfers via CLI or MCP.
🧱 Interaction with smart contracts through ABI functionality.
🔄 Integration with PancakeSwap for trading and liquidity operations.
🧱 Creation of meme tokens and deployment of BEP-20 smart contracts.
🧠 Support for direct integration into Claude Desktop.
🔧 CLI-friendly and MCP-compatible, suitable for developers.
🔑 Password-protected private keys.

📦 Installation

1. Install Node.js and npm

Ensure you have Node.js (version >= 14) and npm installed.

# Check Node.js version
node -v

# Check npm version
npm -v

2. Install bnbchain-mcp globally

npm install -g bnbchain-mcp

3. Start the MCP server

bnbchain-mcp --init

The system will prompt you to enter the following information:

✅ BSC wallet private key (required).
✅ Wallet password (required, must be 6 characters).
✅ Custom RPC URL (optional, default: https://bsc-dataseed.binance.org).

💻 Usage Examples

Basic Commands

Start the server:
```
bnbchain-mcp start
```
Stop the server:
```
bnbchain-mcp stop
```
Reinitialize the configuration:
```
bnbchain-mcp init
```

Example Operations

Send BNB:

bnbchain-mcp transferNativeToken --to <recipient_address> --amount <amount>

Transfer BEP-20 tokens:

bnbchain-mcp transferBEP20Token --tokenAddress <token_address> --to <recipient_address> --amount <amount>

Create a meme token:

bnbchain-mcp createFourMeme --name "<token_name>" --symbol "<symbol>"

📚 Documentation

Claude Desktop Integration

After completing the CLI setup, the tool can be automatically configured in Claude Desktop. 📍 Modified file:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude will detect and run this MCP server, using the tools you've selected.

Supported MCP Tools

Tool Name	Description
`transferNativeToken`	Send BNB to a wallet
`transferBEP20Token`	Transfer BEP-20 tokens using symbol/address
`pancakeSwap`	Conduct token swaps via PancakeSwap
`createFourMeme`	Create a meme token on Four.Meme
`createBEP20Token`	Deploy a BEP-20 contract
`getBalance`	Get token and native token balances
`callContractFunction`	Call smart contract functions through ABI
`getWalletInfo`	Get wallet address information
`securityCheck`	Check the security of BSC tokens
`pancakeAddLiquidity`	Add liquidity on PancakeSwap
`pancakeMyPosition`	View your PancakeSwap positions
`pancakeRemovePosition`	Remove positions from PancakeSwap
`sellMemeToken`	Sell meme tokens on Four.Meme
...and other upcoming features 🔧

Development Process

Compile TypeScript:

npm run build

Start the MCP server:

npm start
# or
node build/index.js

Reconfigure:

bnbchain-mcp --init

Architecture

Core Components:

MCP Interface: Supports the MCP protocol for communication and coordination between tools.
BSC Connection Module: Provides an interface to the Binance Smart Chain for token operations and smart contract interactions.
PancakeSwap Integration: Seamlessly connects to the PancakeSwap platform for trading and liquidity management.
Four.Meme Support: Specialized meme token creation functionality for the Four.Meme platform.

Technical Features:

Supports CLI operations, suitable for direct use by developers.
Provides a graphical interface for easy operation by non-technical users.
Highly scalable, supporting custom modules and plugins.

🤝 Support and Contribution

Community developers are welcome to contribute! If you need help or have any questions, please visit our GitHub repository or join our Discord community.