📦 BNBChain MCP – Binance Smart Chain Tool Server (MCP + CLI Ready)
A comprehensive blockchain tool server for BNB, BEP-20 tokens, smart contract deployment and interaction built on BNB Smart Chain (BSC) and compatible with other EVM networks.
Technology Stack
- Blockchain: BNB Smart Chain (BSC)
- Web3 Libraries: Viem 2.23.11, PancakeSwap SDK 5.8.8
- CLI/Backend: TypeScript, Node.js (ESM)
- Protocol: Model Context Protocol (MCP) SDK 1.4.0
- Security: AES encryption with bcrypt for private key protection
- Token Security: GoPlus SDK for security checks
- Data Provider: Moralis SDK 2.27.2 for blockchain data
Supported Networks
- BNB Smart Chain Mainnet (Chain ID: 56)
- RPC: https://bsc-dataseed.binance.org (default)
- Custom RPC supported via environment configuration
Contract Addresses
| Contract Type | Address | Description |
|---|---|---|
| Four.Meme Try Buy | 0xF251F83e40a78868FcfA3FA4599Dad6494E46034 | Four.Meme token purchase contract |
| Four.Meme Buy/Sell AMAP | 0x5c952063c7fc8610FFDB798152D69F0B9550762b | Four.Meme auto-market-adjusted pricing |
| Four.Meme Create Token | 0x5c952063c7fc8610FFDB798152D69F0B9550762b | Four.Meme token factory |
| PancakeSwap Router V2 | Integrated via SDK | DEX routing and swaps |
| PancakeSwap V3 Pools | Accessed via SDK | Liquidity pools management |
Features
- Low-cost BNB & BEP-20 transfers - Optimized for BSC's low gas fees
- PancakeSwap V2/V3 integration - Automated swaps, liquidity management, and position tracking
- Four.Meme platform support - Create, buy, and sell meme tokens directly
- Security-first architecture - AES-256 encrypted private keys with bcrypt password protection
- Token security analysis - Built-in GoPlus security checks for token verification
- Gas-efficient operations - Smart routing for optimal gas usage on BSC
- AI-ready MCP protocol - Seamless integration with Claude Desktop and AI agents
- Real-time wallet monitoring - Track balances and positions across multiple tokens
🛠 Installation & Setup
1. Install
npm install -g bnbchain-mcp
2. Run the CLI Setup Wizard
bnbchain-mcp --init
You’ll be prompted to enter:
- ✅ BSC Wallet Private Key (required)
- ✅ Wallet Password (required, must be 6 characters)
- ✅ Custom RPC URL (optional, defaults to:
https://bsc-dataseed.binance.org*)
🧠 Claude Desktop Integration
After CLI setup, the tool can auto-configure itself into Claude Desktop.
📍 File modified:
~/Library/Application Support/Claude/claude_desktop_config.json
Claude will detect and run this MCP server with your selected tools.
🔨 Supported MCP Tools
| Tool Name | Description |
|---|---|
transferNativeToken | Send BNB to a wallet |
transferBEP20Token | Transfer BEP-20 token via symbol/address |
pancakeSwap | Swap tokens via PancakeSwap |
createFourMeme | Create meme token on Four.Meme |
createBEP20Token | Deploy a BEP-20 contract |
getBalance | Get token + native balance |
callContractFunction | Custom contract calls via ABI |
getWalletInfo | Get wallet info for an address |
securityCheck | Check token security of BSC tokens |
pancakeAddLiquidity | Add liquidity to PancakeSwap |
pancakeMyPosition | View your PancakeSwap positions |
pancakeRemovePosition | Remove liquidity from PancakeSwap |
sellMemeToken | Sell meme token on Four.Meme |
| ...and more coming soon 🔧 |
🧪 Development Workflow
Compile TypeScript:
npm run build
Start MCP Server:
npm start
# or
node build/index.js
Re-configure:
bnbchain-mcp --init
📘 Model Context Protocol (MCP)
This project is built on Model Context Protocol – a standard to help agents and models interact with structured tool APIs.
MCP Benefits:
- ✅ Structured input/output
- ✅ Claude + OpenAI compatible
- ✅ Secure + serverless-ready
✅ Roadmap
- CLI Configuration Wizard
- Claude Desktop Integration
- Token Deploy + Transfer
- Token charting tools (DEXTools, Gecko)
- Telegram auto-trading agent
- AI assistant with BSC on-chain brain
🤝 Contributing
Feel free to fork, PR, or raise issues. We're building tool-first, AI-ready infrastructure for the next wave of Web3 agents. Join us!
🛡️ License
MIT — Use freely, contribute openly.