Binance MCP Server

Interactúa con la API de Binance para ver carteras, convertir tokens y ejecutar operaciones con un impacto mínimo en el mercado.

GitHub

Prueba este MCPPatrocinado

Documentación

Binance MCP Server

Descripción general

Binance MCP Server es un servicio backend diseñado para interactuar con la API de Binance. Facilita la interacción fluida con el exchange de Binance, permitiendo a los usuarios ver su cartera, convertir tokens y ejecutar operaciones con un impacto mínimo en el mercado. El servidor utiliza el framework Model Context Protocol (MCP) para garantizar transacciones seguras, estructuradas y eficientes.

Funcionalidades clave:

Interactuar con la API del exchange de Binance para información de cuenta y operaciones de trading
Mostrar la composición y valoración de la cartera
Ejecutar conversiones inteligentes de tokens con mitigación del impacto en el mercado
Procesar órdenes de mercado y estrategias de trading algorítmico
Obtener datos de mercado en tiempo real e información de la cuenta
Implementar transacciones estructuradas utilizando el framework Model Context Protocol
Proporcionar autenticación segura y gestión de claves API para la integración con Binance

Características

Requisitos

Antes de configurar el Binance MCP Server, asegúrate de tener instalado lo siguiente:

Node.js (v16 o posterior)
npm o yarn
Clave y secreto de la API de Binance (para la integración con el exchange de Binance)
Una clave privada válida de billetera de Binance Smart Chain (BSC) (para transacciones en blockchain)

Instalación

Clona el repositorio e instala las dependencias:

git clone https://github.com/your-repo/binance-mcp-server.git
cd binance-mcp-server
npm install  # or yarn install

Configuración

Para configurar el servidor, crea un archivo .env en el directorio raíz y especifica las siguientes variables:

# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here

Creación de una clave API de Binance

Antes de usar la integración con la API de Binance, necesitas crear una clave API. Esto te permite conectarte a los servidores de Binance mediante varios lenguajes de programación, extraer datos de Binance e interactuar con aplicaciones externas. Puedes ver tu billetera y datos de transacciones, realizar operaciones y depositar y retirar fondos en programas de terceros.

Requisitos previos:

Debes hacer un depósito de cualquier monto en tu billetera Spot para activar tu cuenta
Completar la verificación de identidad
Habilitar la autenticación de dos factores (2FA) en tu cuenta

Pasos para crear una clave API de Binance:

Inicia sesión en tu cuenta de Binance y haz clic en el ícono de perfil, luego en [Cuenta].
Ve a [Gestión de API] y luego haz clic en [Crear API].
Selecciona el tipo de clave API que prefieras:
- Claves API generadas por el sistema (cifrado simétrico HMAC): recibirás la clave API y la clave secreta.
- Claves API autogeneradas (cifrado asimétrico Ed25519 o RSA): recibirás una clave API, pero tendrás que crear tu propio par de claves pública-privada.
Ingresa una etiqueta/nombre para tu clave API.
Verifica con tus dispositivos 2FA y passkeys.
Tu clave API ya está creada.

Para más detalles sobre la API de Binance, consulta la Documentación de la API de Binance.

Integración con Claude Desktop

Antes de integrar este servidor MCP con Claude Desktop, asegúrate de tener instalado lo siguiente:

Claude Desktop

Luego compila el servidor usando el siguiente comando:

npm run build

Para agregar este servidor MCP a Claude Desktop:

Crea o edita el archivo de configuración de Claude Desktop en:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Agrega la siguiente configuración:

{
    "mcpServers": {
        "binance-mcp": {
            "command": "node",
            "args": [
                "/Users/Username/Desktop/binance-mcp/build/index.js"
            ],
            "env": {
                "BINANCE_API_KEY": "BINANCE_API_KEY",
                "BINANCE_API_SECRET": "BINANCE_API_SECRET"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

Asegúrate de pasar la ubicación correcta del archivo index.js en el campo args.

Reinicia Claude Desktop para que los cambios surtan efecto.

Uso (para conectar un HOST MCP distinto de Claude)

Iniciar el servidor

Para iniciar el servidor MCP, ejecuta:

npm start  # or node index.js

Funciones

Funciones de la API de Binance

Obtener información de la cuenta de Binance - binanceAccountInfo

Recupera información completa sobre tu cuenta de Binance, incluidos saldos, permisos de trading y estado de la cuenta.
Obtener instantánea de la cuenta de Binance - binanceAccountSnapshot

Obtiene una instantánea del estado de tu cuenta de Binance, incluida la información actual del precio de BTC. Incluye el historial de los últimos 30 días.
Consultar el libro de órdenes de Binance - binanceOrderBook
```
{
    "symbol": "BTCUSDT"
}
```
Recupera el libro de órdenes actual para un par de trading especificado, mostrando las órdenes de compra y venta disponibles hasta 50 niveles de profundidad.
Colocar orden de mercado al contado - binanceSpotPlaceOrder
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 0.001,
    // OR
    "quoteOrderQty": 100
}
```
Coloca una orden de mercado para ejecución inmediata al mejor precio disponible. Usa quantity para especificar la cantidad del activo base o quoteOrderQty para especificar la cantidad en la moneda de cotización. Adecuada para órdenes pequeñas.
Colocar orden TWAP - binanceTimeWeightedAveragePriceFutureAlgo
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 1.0,
    "duration": 3600
}
```
Coloca una orden Time-Weighted Average Price (TWAP) que se ejecuta gradualmente durante una duración especificada para minimizar el impacto en el mercado. Adecuada para órdenes grandes que de otro modo podrían causar movimientos de precios significativos.

Model Context Protocol (MCP)

El Model Context Protocol (MCP) es un estándar abierto diseñado para mejorar la forma en que las aplicaciones interactúan con modelos de IA y sistemas computacionales basados en blockchain. MCP establece un contexto estructurado que mejora la eficiencia de las transacciones automatizadas y las aplicaciones descentralizadas.

Beneficios de MCP:

Estandarización: Define un enfoque unificado para las interacciones entre aplicaciones.
Eficiencia: Reduce la sobrecarga computacional y mejora la velocidad de las transacciones.
Interoperabilidad: Admite la integración en múltiples plataformas y ecosistemas blockchain.

Manejo de errores

Cuando una transacción falla, el servidor devuelve un mensaje de error con detalles. Revisa los registros de la consola para obtener más información de depuración. Los escenarios de error comunes incluyen:

Fondos insuficientes en la billetera
Dirección de destinatario no válida
Congestión de red o problemas de RPC
Errores de autenticación de la API de Binance
Restricciones de límites de trading

Licencia

Este proyecto es de código abierto bajo la Licencia MIT.

Para contribuciones, informes de errores o solicitudes de funciones, envía un problema en GitHub.