📦 BNBChain MCP – Binance Smart Chain Tool Server (MCP + CLI Ready) by TermiX-official - MCP Server

📦 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.

TermiX-official/bsc-mcp