Kydlikebtc MCP Server Bn

🚀 mcp-server-cex-bn

This MCP server provides powerful interfaces for Binance spot trading operations.

Chinese Instructions

🚀 Quick Start

This MCP server offers a comprehensive set of tools and interfaces for seamless Binance spot trading. Follow the steps below to get started.

✨ Features

Trading Operations

• Configure and securely store Binance API credentials.
• Execute spot trading operations (LIMIT/MARKET orders).
• Monitor account balances.
• Track and manage open orders.
• Cancel existing orders.

Tools

configure_api_keys

Securely store your Binance API credentials:

await configureBinanceApiKeys({
  apiKey: 'your-api-key',
  apiSecret: 'your-api-secret'
});

create_spot_order

Create LIMIT or MARKET orders:

// LIMIT order
await createSpotOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'LIMIT',
  quantity: '0.001',
  price: '40000'
});

// MARKET order
await createSpotOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'MARKET',
  quantity: '0.001'
});

cancel_order

Cancel an existing order:

await cancelOrder({
  symbol: 'BTCUSDT',
  orderId: '12345678'
});

get_balances

Check your account balances:

const balances = await getBalances();
// Returns: { BTC: '0.1', USDT: '1000', ... }

get_open_orders

List all open orders:

const orders = await getOpenOrders({
  symbol: 'BTCUSDT' // Optional: specify a symbol
});

📚 Documentation

Security Considerations

• Never commit API keys to version control.
• Use environment variables or secure key storage.
• Limit API key permissions to only the required operations.
• Rotate your API keys regularly.

Rate Limits

• Comply with Binance API rate limits.
• Default rate limits:
  • 1200 requests per minute for order operations.
  • 100 requests per second for market data.
• Implement appropriate error handling for rate limit errors.

Error Handling

Common error scenarios:

• Invalid API credentials.
• Insufficient balance.
• Invalid order parameters.
• Rate limit exceeded.
• Network connectivity issues.

Example error handling:

try {
  await createSpotOrder({
    symbol: 'BTCUSDT',
    side: 'BUY',
    type: 'LIMIT',
    quantity: '0.001',
    price: '40000'
  });
} catch (error) {
  if (error.code === -2010) {
    console.error('Insufficient balance');
  } else if (error.code === -1021) {
    console.error('Rate limit exceeded');
  }
}

Project Structure

.
├── src/
│   ├── index.ts                 # Server entry point
│   ├── services/
│   │   ├── binance.ts          # Binance API integration
│   │   ├── keystore.ts         # API key management
│   │   └── spot_order.ts       # Spot order processing
│   └── README.md               # Project documentation
└── package.json                # Package configuration file

Development

1. Set up environment variables:

cp .env.example .env

2. Install dependencies:

npm install

3. Build and start the server:

npm run build
npm start

4. Debugging tools: Use the MCP Inspector for debugging.

📦 Installation

1. Clone the repository:

git clone [url]
cd mcp-server-cex-bn

2. Configure API keys: Edit the .env file and add your Binance API credentials.

3. Start the server:

npm start

With these steps, you can easily start using the MCP server for Binance spot trading.