binance-mcp-server

This project is a high-performance, secure Model Context Protocol (MCP) server designed to connect AI assistants (like Claude) with your Binance Spot and Futures accounts. Built on FastAPI and FastMCP, it provides advanced financial and trading tools, robust security features, terminal-aesthetic dashboards, and intelligent proxy/IP management for handling API key whitelisting requirements.

• Multi-Market Support: Connects directly to Binance Spot and USDT-M Futures.
• Streamable HTTP MCP Transport: Seamless remote Claude.ai integration over standard HTTPS.
• Market Data Retrieval: Real-time prices, order books, OHLCV (candlesticks), and 24h tickers.
• On-Demand Technical Analysis: Built-in calculation of advanced indicators including RSI, MACD, and Bollinger Bands using pandas-ta.
• High Security & Hardening:
• AES-256-GCM encrypted API key management via admin dashboard.
• Multi-layered security middleware (rate limiting, HTTPS enforcement, MCP token verification).
• Dynamic Public IP Tracking: Multi-provider discovery system to pinpoint the real server IP, essential for Binance API Key IP Whitelisting (especially on platforms with dynamic exit nodes like Heroku).

---

• Framework: FastAPI, Uvicorn, Streamable Starlette Sessions, Jinja2 Templates
• MCP Protocol: FastMCP (mcp library)
• Exchange SDK: python-binance
• Data & Math: pandas, pandas-ta
• Security: pycryptodomex, itsdangerous

---

These are the core environment variables to configure your server. For VPS, create a .env file in the root directory. For Heroku, set these in the "Settings > Config Vars" tab.

| Variable | Description | |--------------------------|----------------------------------------------------------------------------------