Skip to main content
Glama
enesjakozh

MCP Server for Binance Spot Trading

by kydlikebtc
npmGitHub
TypeScript
7
13
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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' });

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

  1. 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

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

  2. 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

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Este servidor proporciona una interfaz robusta para las operaciones de trading al contado de Binance, incluida la gestión segura de credenciales API, la ejecución y gestión de órdenes al contado y el monitoreo de saldos de cuentas y órdenes abiertas.

  1. Características
    1. Operaciones de comercio al contado
    2. Operaciones de negociación de futuros
    3. Herramientas
  2. Detalles de la negociación de futuros
    1. Modos de posición
    2. Tipos de margen
    3. Tasa de financiación
  3. Consideraciones de seguridad
    1. Seguridad en el comercio al contado
    2. Seguridad en el comercio de futuros
  4. Límites de velocidad
    1. Manejo de errores
      1. Escenarios de error comunes
      2. Errores específicos del futuro
    2. Estructura del proyecto
      1. Desarrollo
        1. Instalación
          1. Instalación mediante herrería
          2. Instalación manual
          3. Depuración
        2. servidor mcp-bn

          Related Resources

          Related MCP Servers

          • Binance MCP Server

            qeinfinity
            A
            security
            A
            license
            A
            quality
            A server implementation that streams real-time Binance market data (spot and futures) via WebSockets, enabling applications to receive and process cryptocurrency market information through the Model Context Protocol.
            Last updated -
            6
            33
            18
            MIT License

          • Binance MCP Server

            TermiX-official
            A
            security
            F
            license
            A
            quality
            A backend service that enables interaction with the Binance exchange API, allowing users to view their portfolio, convert tokens, and execute trades with minimal market impact.
            Last updated -
            1
            12
            56
            • Apple
            • Linux

          • Binance MCP Server

            sutarrohit
            -
            security
            F
            license
            -
            quality
            Backend service that enables users to connect with Binance exchange for viewing portfolio data, converting tokens, and executing trades with minimal market impact through the Model Context Protocol framework.
            Last updated -
            12
            • Apple
            • Linux

          • Upbit MCP SSE Server

            restful3
            -
            security
            A
            license
            -
            quality
            A server that enables interaction with Upbit cryptocurrency exchange API through Server-Sent Events, allowing users to access market data, manage accounts, execute trades, and perform technical analysis.
            Last updated -
            1
            MIT License

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/kydlikebtc/mcp-server-bn'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server