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
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'
});
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:
Construir el servidor:
Para desarrollo con reconstrucción automática:
Instalación
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:
- Configura tus credenciales de API de Binance en
.env - Construya e inicie el servidor:
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:
El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.
servidor mcp-bn