src/
  binance/            Layer 1 — Binance HTTP client
    client.ts         signedRequest / publicRequest, retry, timeout
    signing.ts        HMAC SHA256
    errors.ts         typed error classes
    rateLimiter.ts    weight tracking + backoff
    types.ts          response types
  services/           Layer 2 — domain services (normalization)
    marketDataService.ts
    accountService.ts
  tools/              Layer 3 — MCP tools (1 file = 1 tool)
    getSpotPrice.ts ... getTradeHistory.ts
  config.ts           .env validation (zod)
  logger.ts           structured JSON logging
  server.ts           MCP server registration
tests/
  unit/               signing, errors, rateLimiter, services, client

# 1. Install
npm install

# 2. Configure (Binance Spot TESTNET keys)
cp .env.example .env
# Edit .env with your testnet keys

# 3. Run the MCP server
npm run dev

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["tsx", "/path/to/binance-trading-agent-mcp/src/server.ts"]
    }
  }
}

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["tsx", "/path/to/binance-trading-agent-mcp/src/server.ts"]
    }
  }
}

tool: get_spot_price
args: { "symbol": "BTCUSDT" }

tool: get_klines
args: { "symbol": "BTCUSDT", "interval": "1h", "limit": 100 }

tool: get_order_book
args: { "symbol": "ETHUSDT", "limit": 20 }

tool: get_symbol_rules
args: { "symbol": "BTCUSDT" }

tool: get_account_balances
args: { "hideZero": true }

tool: get_open_orders
args: { "symbol": "BTCUSDT" }

tool: get_trade_history
args: { "symbol": "BTCUSDT", "limit": 50 }

# Run all unit tests
npm test

# Watch mode
npm run test:watch