BSC - MCP Server: Integrates Wallet Management, Supports Claude Desktop for Secure AI

Bsc MCP

BNBChain MCP is a server based on the Model Context Protocol (MCP), providing secure interaction between AI agents and applications with the Binance Smart Chain (BSC) ecosystem. It integrates functions such as wallet management, token transfer, PancakeSwap decentralized exchange operations, Meme token trading, and GoPlus security analysis. It is developed using TypeScript and supports seamless integration with Claude Desktop.

Finance Artificial intelligence chatbots #Blockchain interaction #DeFi tool #AI agent #Secure trading .TypeScript

rating : 2.5 points

downloads : 6.1K

update time : 2025-12-03

Open Site

What is BNBChain MCP?

BNBChain MCP is a blockchain interaction tool specifically designed for AI assistants (such as Claude). It enables AI to securely operate various functions on the BNB Smart Chain for you, including transfers, trading, liquidity management, etc., without you having to write complex blockchain code yourself.

How to use BNBChain MCP?

Simply configure your wallet information, and then you can operate your blockchain assets through an AI assistant (such as Claude Desktop). You can talk to the assistant like saying 'Transfer 0.1 BNB to my friend' or 'Buy a certain token with $100', and the AI will securely complete the operation for you.

Applicable scenarios

Suitable for users who want to simplify blockchain operations through AI, including: daily transfers, token trading, liquidity mining, participating in new projects, etc. Especially suitable for users who are not familiar with blockchain technology but want to participate in DeFi.

Main features

Wallet management

Securely manage your BNB Smart Chain wallet, including checking balances, transferring BNB and tokens. All private keys are encrypted and stored to ensure security.

PancakeSwap trading

Directly conduct token exchanges, add liquidity, and manage liquidity positions on the PancakeSwap decentralized exchange. Supports V2 and V3 versions.

Meme token trading

Trade popular meme tokens on the Four.Meme platform, supporting buying, selling, and querying detailed token information.

Security analysis

Use the GoPlus security service to check the security of tokens and identify potential risks before trading.

AI assistant integration

Seamlessly integrate with AI assistants such as Claude Desktop and operate the blockchain through natural language instructions.

Advantages

No programming knowledge required: Complete complex blockchain operations by interacting with AI through natural language

Highly secure: Private keys are encrypted using AES - 256, and passwords are protected using bcrypt hashing

One - stop service: Integrates multiple functions such as wallet management, DEX trading, and meme token trading

User - friendly: Simple configuration, with an interactive setup wizard to guide you through the initialization

Real - time security check: Automatically conduct token security analysis before trading

Limitations

Depends on AI assistants: Needs to be used in conjunction with MCP - compatible AI assistants such as Claude

Only supports the BNB chain: Currently mainly focuses on the BNB Smart Chain ecosystem

Requires network connection: All operations need to be connected to the blockchain network

Learning curve: Although the operations are simplified, you still need to understand basic blockchain concepts

How to use

Install the tool

Install the BNBChain MCP tool globally via npm

Initialize the configuration

Run the configuration wizard and enter your wallet private key and set a password. The private key will be encrypted and stored to ensure security.

Start the MCP server

Start the MCP server, which will automatically configure the integration with Claude Desktop

Use in Claude

Open Claude Desktop, and now you can operate the blockchain through conversations

Usage examples

Daily transfer to a friend

You want to transfer some BNB to a friend but don't know how to operate the blockchain wallet

Participate in new token trading

You've heard about a new meme token and want to participate in it with a small amount

Provide liquidity to earn income

You have some idle BNB and USDT and want to provide liquidity to earn trading fees

Frequently Asked Questions

Is my private key safe?

How much BNB is needed to pay the Gas fee?

Which AI assistants are supported?

What if the transaction fails?

Can I manage multiple wallets simultaneously?

Related resources

Official GitHub repository

Get the latest code, submit issues, and participate in development

Model Context Protocol official website

Understand the technical details and specifications of the MCP protocol

BNB Smart Chain documentation

Learn the basic knowledge and latest developments of the BNB Smart Chain

PancakeSwap official website

Understand the functions of the PancakeSwap decentralized exchange

🚀 BNBChain MCP

A comprehensive Model Context Protocol (MCP) server for interacting with Binance Smart Chain (BSC), providing secure and efficient tools for token transfers, DEX operations, and smart contract interactions.

🚀 Quick Start

1. Initial Configuration

Run the interactive setup wizard:

bnbchain-mcp --init

The wizard will prompt you for:

BSC Wallet Private Key (required) - Your wallet's private key
Wallet Password (required) - Minimum 6 characters for encryption
Custom RPC URL (optional) - Defaults to Binance public RPC

2. Verify Installation

bnbchain-mcp --version

3. Start MCP Server

npm start
# or
node build/index.js

✨ Features

🔐 Security

AES-256 encryption for private key storage
bcrypt password protection for wallet credentials
GoPlus security integration for token verification
Secure configuration management

💱 DeFi Operations

PancakeSwap V2/V3 integration for token swaps
Liquidity management (add/remove positions)
Position tracking and portfolio management
Gas-optimized transaction routing

🪙 Token Management

Native BNB transfers
BEP-20 token transfers via symbol or address
Meme token creation and trading (Four.Meme platform)
Token security analysis and verification

🤖 AI-Ready

Model Context Protocol (MCP) compliant
Seamless Claude Desktop integration
Structured tool APIs for AI agents
Type-safe TypeScript implementation

📦 Installation

Prerequisites

Node.js 18+ (ESM support required)
npm or yarn package manager

Global Installation

npm install -g bnbchain-mcp

Local Development

git clone <repository-url>
cd bsc-mcp
npm install
npm run build

💻 Usage Examples

Basic Usage

# Run the interactive setup wizard
bnbchain-mcp --init

# Verify installation
bnbchain-mcp --version

# Start MCP Server
npm start

Advanced Usage

# Build and initialize
npm run init:build

# Auto-publish (for maintainers)
npm run publish:auto

📚 Documentation

Technology Stack

Property	Details
Blockchain	Binance Smart Chain (BSC)
Web3 Library	Viem 2.23.11
DEX SDK	PancakeSwap SDK 5.8.8
Protocol	Model Context Protocol SDK 1.4.0
Language	TypeScript (ESM)
Security	AES-256, bcrypt
Data Provider	Moralis SDK 2.27.2
Token Security	GoPlus SDK 1.0.12

Supported Networks

BNB Smart Chain Mainnet

Chain ID: 56
Default RPC: https://bsc-dataseed.binance.org
Custom RPC: Configurable via environment settings

Available Tools

Wallet Operations

Tool	Description	Parameters
`transferNativeToken`	Transfer BNB to a wallet address	`to`, `amount`
`transferBEP20Token`	Transfer BEP-20 tokens by symbol or address	`token`, `to`, `amount`
`getWalletInfo`	Retrieve comprehensive wallet information	`address`
`getBalance`	Get token and native balance for an address	`address`, `token` (optional)

PancakeSwap Operations

Tool	Description	Parameters
`pancakeSwap`	Execute token swaps via PancakeSwap	`tokenIn`, `tokenOut`, `amount`, `slippage`
`pancakeAddLiquidity`	Add liquidity to PancakeSwap pools	`tokenA`, `tokenB`, `amountA`, `amountB`
`pancakeMyPosition`	View your PancakeSwap liquidity positions	`poolAddress` (optional)
`pancakeRemovePosition`	Remove liquidity from PancakeSwap	`poolAddress`, `liquidity`

Meme Token Operations

Tool	Description	Parameters
`buyMemeToken`	Purchase meme tokens on Four.Meme	`tokenAddress`, `amount`
`sellMemeToken`	Sell meme tokens on Four.Meme	`tokenAddress`, `amount`
`queryMemeTokenDetails`	Get detailed information about meme tokens	`tokenAddress`

Security & Analysis

Tool	Description	Parameters
`securityCheck`	Perform GoPlus security analysis on tokens	`tokenAddress`

Contract Addresses

Contract Type	Address	Description
Four.Meme Try Buy	`0xF251F83e40a78868FcfA3FA4599Dad6494E46034`	Token purchase contract
Four.Meme Buy/Sell AMAP	`0x5c952063c7fc8610FFDB798152D69F0B9550762b`	Auto-market-adjusted pricing
Four.Meme Create Token	`0x5c952063c7fc8610FFDB798152D69F0B9550762b`	Token factory contract
PancakeSwap Router V2	Integrated via SDK	DEX routing and swaps
PancakeSwap V3 Pools	Accessed via SDK	Liquidity pools management

Configuration

Configuration is stored in an encrypted format at:

macOS/Linux: ~/.bnbchain-mcp/config.json
Windows: %USERPROFILE%\.bnbchain-mcp\config.json

Environment Variables

Optional environment variables can be set:

BSC_RPC_URL: Custom RPC endpoint
MORALIS_API_KEY: Moralis API key for enhanced data access

Roadmap

Completed ✅

[x] CLI configuration wizard
[x] Claude Desktop integration
[x] Token deployment and transfers
[x] PancakeSwap V2/V3 integration
[x] Meme token trading support
[x] Security analysis tools

In Progress 🚧

[ ] Enhanced error handling and retry logic
[ ] Multi-wallet support
[ ] Transaction history tracking

Planned 📋

[ ] Token charting integration (DEXTools, CoinGecko)
[ ] Telegram bot integration
[ ] Advanced AI trading strategies
[ ] Cross-chain bridge support

🔧 Technical Details

Project Structure

bsc-mcp/
├── src/
│   ├── cli/              # CLI command handlers
│   ├── functions/        # Core business logic
│   ├── tools/            # MCP tool implementations
│   ├── lib/              # Shared libraries and ABIs
│   ├── types/            # TypeScript type definitions
│   ├── config.ts         # Configuration management
│   ├── main.ts           # MCP server entry point
│   └── index.ts          # CLI entry point
├── build/                # Compiled JavaScript output
└── scripts/              # Build and deployment scripts

Security Architecture

Private Key Encryption: AES-256 encryption with user-provided password
Password Hashing: bcrypt for secure password storage
Configuration Storage: Encrypted local configuration files
Token Verification: GoPlus SDK integration for security checks

Model Context Protocol (MCP)

This project implements the Model Context Protocol, a standardized protocol for AI agents to interact with external tools and data sources.

MCP Benefits

✅ Structured Communication: Type-safe request/response patterns
✅ AI Agent Compatibility: Works with Claude, OpenAI, and other MCP-compatible agents
✅ Secure Architecture: Server-based execution with encrypted credentials
✅ Extensible Design: Easy to add new tools and capabilities

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

⚠️ Important Note

Never share your private keys or wallet passwords

Use strong passwords (minimum 6 characters, but longer is recommended)

Keep your configuration files secure and never commit them to version control

Verify token addresses before executing transactions

Test with small amounts before large transactions

Review security check results before trading unknown tokens

💡 Usage Tip

Optional environment variables can be set: BSC_RPC_URL for custom RPC endpoint and MORALIS_API_KEY for Moralis API key to enhance data access.