mcp -bn

This MCP server provides integrated Binance trading capabilities for both spot and futures markets. It exposes a comprehensive set of trading tools, including creating and cancelling spot orders, checking balances and open orders, and managing futures positions, leverage, and a variety of futures order types. Before running, configure your Binance API credentials via environment variables or a secure keystore as demonstrated in the examples. Once running, you can use the provided tooling to programmatically place orders, query accounts, and adjust risk parameters through a consistent MCP interface. The server is designed to be consumed by MCP clients and debugging tools, enabling automated trading workflows and monitoring across spot and futures markets.

Prerequisites:

• Node.js (LTS) and npm/yarn/pnpm installed
• Access to Binance API keys with appropriate permissions for spot and futures

Installation steps:

1. Clone the repository or install via Smithery (as described in the README):

   • Manual install:
     • git clone <repository-url>
     • cd into the project
     • Install dependencies: pnpm install
     • Configure API credentials: create a .env file with BINANCE_API_KEY and BINANCE_API_SECRET or set environment variables accordingly
     • Build and start: pnpm build pnpm start

2. Optional Smithery installation: npx -y @smithery/cli install mcp-server-cex-bn --client claude

3. Run the server:

   • Ensure environment variables are set (BINANCE_API_KEY, BINANCE_API_SECRET)
   • Start the server (if using npm scripts, e.g., pnpm start) and verify it initializes successfully

Notes:

• The server communicates over standard I/O (stdio) for MCP compatibility.
• Use pnpm install to ensure dependencies resolve properly, and pnpm build to compile TypeScript sources to JavaScript for runtime execution.

Environment variables and security tips:

• Never commit API keys to version control. Prefer .env files or secure secret storage.
• Restrict API key permissions to only what is required (spot and futures trading operations).
• Consider using separate API keys for development and production.

Operational tips:

• Monitor rate limits as Binance enforces per-endpoint quotas; implement error handling for rate limit responses.
• Use reduce-only and stop-loss orders to manage risk in futures trading.
• When debugging MCP servers, MCP Inspector can help inspect stdio communication and runtime behavior.