servidor mcp-cex-bn

Este servidor MCP proporciona una integración integral con las operaciones comerciales al contado y de futuros de Binance.

Lengua china

Características

Operaciones de comercio al contado

• Ejecutar operaciones de trading spot (órdenes LÍMITE/MERCADO)

• Monitorear los saldos de las cuentas

• Seguimiento y gestión de órdenes abiertas

• Cancelar pedidos existentes

Operaciones de negociación de futuros

• Crear varios tipos de órdenes de futuros (LIMIT, MARKET, STOP, TAKE_PROFIT, etc.)

• Administrar la configuración del apalancamiento (1-125x)

• Monitorear posiciones de futuros e información de cuentas

• Seguimiento de las tasas de financiación

• Soporte para posiciones tanto en modo unidireccional como de cobertura

• Tipos de órdenes avanzadas, incluidas órdenes de stop dinámico y órdenes de solo reducción

Herramientas

Configuración de API

configure_api_keys

Almacene de forma segura sus credenciales de API de Binance:

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

Herramientas de trading al contado

create_spot_order

Crear órdenes LIMIT o MARKET:

// 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

Cancelar un pedido existente:

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

get_balances

Consulta los saldos de tus cuentas:

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

get_open_orders

Listado de todas las órdenes abiertas:

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

Herramientas para el trading de futuros

create_futures_order

Crear varios tipos de órdenes de futuros:

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

// STOP MARKET order
await createFuturesOrder({
  symbol: 'BTCUSDT',
  side: 'SELL',
  type: 'STOP_MARKET',
  quantity: '0.001',
  stopPrice: '38000'
});

// TRAILING STOP order
await createFuturesOrder({
  symbol: 'BTCUSDT',
  side: 'SELL',
  type: 'TRAILING_STOP_MARKET',
  quantity: '0.001',
  callbackRate: '1.0' // 1% callback rate
});

set_futures_leverage

Ajustar el apalancamiento para un par comercial:

await setFuturesLeverage({
  symbol: 'BTCUSDT',
  leverage: 10  // 1-125x
});

get_futures_positions

Obtenga todas las posiciones de futuros abiertas:

const positions = await getFuturesPositions();

get_futures_account

Obtenga información detallada de la cuenta de futuros:

const account = await getFuturesAccount();

get_funding_rate

Obtenga la tasa de financiación para un símbolo de futuros:

const fundingRate = await getFundingRate({
  symbol: 'BTCUSDT'
});

cancel_futures_order

Cancelar una orden de futuros existente:

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

Related MCP server: Binance MCP Server

Detalles de la negociación de futuros

Modos de posición

• Modo unidireccional: una sola posición por símbolo

  • Modo predeterminado, gestión de posición más sencilla

  • El tamaño total de la posición es la suma de todos los pedidos

• Modo de cobertura: Separar posiciones largas y cortas

  • Permite mantener posiciones largas y cortas simultáneamente

  • Cada posición tiene requisitos de margen independientes

Tipos de margen

• Margen aislado: Margen fijo por posición

  • El riesgo se limita al margen asignado

  • Cada posición tiene su propia configuración de apalancamiento

• Margen cruzado: margen compartido entre posiciones

  • Mayor eficiencia del capital

  • Riesgo compartido entre todas las posiciones

Tasa de financiación

Los contratos de futuros perpetuos utilizan tasas de financiación para mantener los precios de futuros alineados con los precios al contado:

• Tasa positiva: Los largos pagan a los cortos

• Tasa negativa: los cortos pagan a los largos

• Los pagos se realizan cada 8 horas

Consideraciones de seguridad

Seguridad en el comercio al contado

• Nunca envíe claves API al control de versiones

• Utilice variables de entorno o almacenamiento de claves seguro

• Restringir los permisos de clave API únicamente a las operaciones requeridas

• Rote regularmente sus claves API

Seguridad en el comercio de futuros

• Establecer límites de apalancamiento adecuados en función de la tolerancia al riesgo

• Utilice siempre órdenes de stop-loss para limitar posibles pérdidas

• Vigile atentamente los precios de liquidación

• Verifique periódicamente los riesgos de posición y los ratios de margen

• Considere utilizar órdenes de solo reducción para la gestión de riesgos

• Tenga cuidado con el margen cruzado debido al riesgo compartido

Límites de velocidad

• Respete los límites de velocidad de la API de Binance

• Límites de velocidad predeterminados:

  • 1200 solicitudes por minuto para operaciones de pedidos

  • 100 solicitudes por segundo de datos de mercado

• Implementar un manejo adecuado de errores para errores de límite de velocidad

Manejo de errores

Escenarios de error comunes

• Credenciales de API no válidas

• Saldo o margen insuficiente

• Parámetros de pedido no válidos

• Límite de velocidad excedido

• Problemas de conectividad de red

Errores específicos del futuro

• InsufficientMarginError: No hay suficiente margen para la operación

• InvalidPositionModeError: Configuración de modo de posición incorrecta

• OrderValidationError: parámetros de orden de futuros no válidos

Ejemplo de manejo de errores:

try {
  await createFuturesOrder({
    symbol: 'BTCUSDT',
    side: 'BUY',
    type: 'LIMIT',
    quantity: '0.001',
    price: '40000',
    timeInForce: 'GTC'
  });
} catch (error) {
  if (error instanceof InsufficientMarginError) {
    console.error('Insufficient margin available');
  } else if (error instanceof InvalidPositionModeError) {
    console.error('Invalid position mode');
  } else if (error instanceof OrderValidationError) {
    console.error('Invalid order parameters');
  }
}

Estructura del proyecto

.
├── src/
│   ├── index.ts                 # Server entry point
│   ├── services/
│   │   ├── binance.ts          # Binance API integration
│   │   ├── keystore.ts         # API key management
│   │   └── tools.ts            # Trading tools implementation
│   └── types/
│       ├── binance.ts          # Binance types
│       └── binance-connector.d.ts  # API client types
├── README.md
├── README_CN.md
├── package.json
├── pnpm-lock.yaml
└── tsconfig.json

Desarrollo

1. Configurar variables de entorno:

Cree un archivo .env en el directorio raíz y configure sus credenciales de API de Binance:

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_secret_key_here

2. Instalar dependencias:

pnpm install

Construir el servidor:

pnpm build

Para desarrollo con reconstrucción automática:

pnpm watch

Instalación

Instalación mediante herrería

Para instalar Binance Trading Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install mcp-server-cex-bn --client claude

Instalación manual

1. Clonar el repositorio

2. Instalar dependencias:

pnpm install

3. Configura tus credenciales de API de Binance en .env

4. Construya e inicie el servidor:

pnpm build
pnpm start

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

pnpm inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

servidor mcp-bn