MCP 服务器

node2flow/binance-mcp

Provides 23 tools for interacting with Binance exchange, including market data, trading, order management, and account queries via the Model Context Protocol. Supports both public market data (no API key required) and authenticated operations like placing and canceling orders.

README

@node2flow/binance-mcp

MCP server for Binance Global — the world's largest cryptocurrency exchange. 23 tools for market data, trading, orders, and account management via the Model Context Protocol.

Quick Start

Claude Desktop / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["-y", "@node2flow/binance-mcp"],
      "env": {
        "BINANCE_API_KEY": "your-api-key",
        "BINANCE_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Note: API keys are optional. 11 market data tools work without authentication.

HTTP Mode

BINANCE_API_KEY=xxx BINANCE_SECRET_KEY=xxx npx @node2flow/binance-mcp --http

MCP endpoint: http://localhost:3000/mcp

Cloudflare Worker

Available at: https://binance-mcp-community.node2flow.net/mcp

POST https://binance-mcp-community.node2flow.net/mcp?BINANCE_API_KEY=xxx&BINANCE_SECRET_KEY=xxx

Tools (23)

Market Data (11) — Public, No API Key Required

Tool	Description
`bn_ping`	Test API connectivity
`bn_server_time`	Get server time (ms timestamp)
`bn_exchange_info`	Trading rules, symbols, filters
`bn_order_book`	Order book depth (bids/asks)
`bn_recent_trades`	Recent trades (up to 1000)
`bn_aggregate_trades`	Compressed/aggregated trades
`bn_klines`	Candlestick/OHLCV data
`bn_avg_price`	Current 5-min average price
`bn_ticker_24hr`	24hr price change statistics
`bn_ticker_price`	Latest price (single or all)
`bn_book_ticker`	Best bid/ask price & quantity

Trading (7) — Requires API Key

Tool	Description	Risk
`bn_test_order`	Test order (dry run, no funds used)	Safe
`bn_new_order`	Place real order	Real money
`bn_query_order`	Query order status	Read-only
`bn_open_orders`	List open orders	Read-only
`bn_all_orders`	All order history	Read-only
`bn_cancel_order`	Cancel single order	Destructive
`bn_cancel_all_orders`	Cancel ALL open orders	Destructive

Account (2) — Requires API Key

Tool	Description
`bn_account_info`	Balances, commissions, permissions
`bn_my_trades`	Trade execution history

User Data Stream (3) — Requires API Key

Tool	Description
`bn_create_listen_key`	Create WebSocket listen key
`bn_keepalive_listen_key`	Extend listen key (every 60min)
`bn_close_listen_key`	Close/invalidate listen key

Test Orders (Safe Trading)

Binance provides a test order endpoint that validates all parameters without executing:

bn_test_order → validates symbol, quantity, price, filters
bn_new_order  → actually places the order (REAL MONEY)

Always use bn_test_order first to verify your order parameters are valid before placing a real order with bn_new_order.

API Key Setup

Go to Binance API Management
Create a new API key
Enable permissions:
- Enable Reading — Required for account/order queries
- Enable Spot Trading — Required for placing/canceling orders
Recommended: Set IP whitelist for security