Binance MCP Server

A Model Context Protocol (MCP) server for cryptocurrency trading on Binance and Base network interactions. This server provides tools for automated trading, market analysis, and blockchain operations.

Features

• Binance Trading Tools: Place orders, check balances, fetch market data, and calculate technical indicators.

• Base Network Integration: Monitor blockchain status and prepare for DeFi operations.

• Technical Analysis: Built-in RSI, MACD, Bollinger Bands, and moving averages.

• Secure API Handling: Environment variables for API keys.

Installation

1. Clone or navigate to the project directory.

2. Create a virtual environment:

   python3 -m venv .venv

3. Activate the virtual environment:

   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

4. Upgrade pip and install dependencies:

   pip install --upgrade pip
   pip install -r requirements.txt

Environment Variables

Create a .env file in the root directory with your API credentials:

# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_SECRET_KEY=your_binance_secret_key_here

Security Note: Never commit the .env file to version control. It is already included in .gitignore.

Running the MCP Server

Start the server with Server-Sent Events (SSE) transport:

python mcp_server.py

The server will run on http://127.0.0.1:8080/sse by default.

Available Tools

The MCP server exposes the following tools for integration with AI agents:

Trading Tools

• get_account_balance(asset="USDT"): Get balance for a specific asset.

• get_market_price(symbol="BTCUSDT"): Get current market price.

• fetch_chart_data(symbol="BTCUSDT", interval="1h", limit=100): Fetch historical OHLCV data.

• calculate_indicators(symbol="BTCUSDT", interval="1h", limit=100): Calculate technical indicators (RSI, MACD, Bollinger Bands, etc.).

• get_symbol_rules(symbol="BTCUSDT"): Get trading rules and precision requirements.

• adjust_leverage(symbol="BTCUSDT", leverage=5): Adjust leverage for futures trading.

• place_order(symbol="BTCUSDT", side="BUY", quantity=0.001): Place a market order.

Blockchain Tools

• get_base_network_status(): Check Base network health (block number, gas price).

Utility Tools

• read_bot_logs(lines=20, log_type="general"): Read bot logs for debugging.

Testing

Run the tests to verify functionality:

python -m pytest tests/

Or run a specific test:

python tests/test_mcp_registration.py

Configuration

Trading parameters can be adjusted in config.py:

• TRADING_PAIRS: List of symbols to trade.

• MIN_ORDER_VALUE: Minimum order value in USDT.

• STOP_LOSS_PERCENTAGE: Stop loss percentage.

• TAKE_PROFIT_PERCENTAGE: Take profit percentage.

• POLLING_INTERVAL: Time between checks (in seconds).

Security Considerations

• Use testnet for initial testing.

• Implement proper risk management.

• Monitor API rate limits.

• Keep API keys secure and rotate regularly.

Contributing

1. Fork the repository.

2. Create a feature branch.

3. Make your changes.

4. Add tests for new functionality.

5. Submit a pull request.

License

This project is licensed under the MIT License.