servidor mcp-cex-bn

insignia de herrería

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

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

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

Clonar el repositorio
Instalar dependencias:

pnpm install

Configura tus credenciales de API de Binance en .env
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-cex-bn

Características

Operaciones de comercio al contado

Operaciones de negociación de futuros

Herramientas

Configuración de API

configure_api_keys

Herramientas de trading al contado

create_spot_order

cancel_order

get_balances

get_open_orders