Skip to content

TermiX-official/bsc-mcp

Repository files navigation


📦 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


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.


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published