# 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:
```bash
python3 -m venv .venv
```
3. Activate the virtual environment:
```bash
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
4. Upgrade pip and install dependencies:
```bash
pip install --upgrade pip
pip install -r requirements.txt
```
## Environment Variables
Create a `.env` file in the root directory with your API credentials:
```env
# 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:
```bash
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:
```bash
python -m pytest tests/
```
Or run a specific test:
```bash
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.
