Servidor MCP de Binance

Descripción general

El Servidor MCP de Binance es un servicio backend diseñado para interactuar con la API de Binance. Facilita una interacción fluida con el exchange de Binance, permitiendo a los usuarios consultar su cartera, convertir tokens y realizar operaciones con un impacto mínimo en el mercado. El servidor utiliza el marco del Protocolo de Contexto de Modelo (MCP) para garantizar transacciones seguras, estructuradas y eficientes.

Funcionalidades clave:

• Interactúe con la API de intercambio de Binance para obtener información de la cuenta y realizar operaciones.

• Mostrar la composición y valoración de la cartera

• Ejecute conversiones de tokens inteligentes con mitigación del impacto en el mercado

• Procesar órdenes de mercado y estrategias de trading algorítmico

• Recupere datos comerciales e información de la cuenta en tiempo real

• Implementar transacciones estructuradas utilizando el marco del Protocolo de Contexto de Modelo

• Proporcionar autenticación segura y gestión de claves API para la integración de Binance

Related MCP server: BSC MCP Server

Características

• [x] Integración de la API de Binance : conéctese al intercambio de Binance para obtener información de la cuenta y operaciones comerciales

• [x] Gestión de cartera : vea la composición detallada de la cartera, el valor de mercado y la asignación porcentual.

• [x] Análisis de cartera : seguimiento opcional del valor histórico para supervisar el rendimiento a lo largo del tiempo

• [x] Conversión inteligente de tokens : Convierte entre tokens con estrategias de ejecución de órdenes inteligentes

• [x] Mitigación del impacto en el mercado : utilice automáticamente el comercio algorítmico para órdenes más grandes para evitar deslizamientos de precios.

• [x] Gestión de cuentas : recupere información detallada de la cuenta, saldos e historial de operaciones

• [x] Acceso a datos de mercado : acceda a libros de órdenes y datos de mercado en tiempo real para tomar decisiones comerciales informadas

• [x] Ejecución de órdenes : coloque órdenes en el mercado spot con especificaciones de cantidad flexibles

• [ ] Soporte de trading algorítmico : Implemente órdenes de precio promedio ponderado en el tiempo (TWAP) para minimizar el impacto en el mercado

• [ ] Trading automatizado : ejecute operaciones programáticamente según estrategias predefinidas

• [ ] Autenticación segura : administre claves API y conexiones seguras a los servicios de Binance

• [ ] Manejo integral de errores : informes detallados de errores para fallas de transacciones y problemas de API

Requisitos

Antes de configurar el servidor Binance MCP, asegúrese de tener instalado lo siguiente:

• Node.js (v16 o posterior)

• npm o hilo

• Clave y secreto de API de Binance (para la integración con el exchange de Binance)

• Una clave privada válida de la billetera Binance Smart Chain (BSC) (para transacciones en blockchain)

Instalación

Clonar el repositorio e instalar 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, cree un archivo .env en el directorio raíz y especifique 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 de la API de Binance, necesita crear una clave API. Esto le permite conectarse a los servidores de Binance mediante varios lenguajes de programación, extraer datos de Binance e interactuar con aplicaciones externas. Puede ver los datos de su billetera y transacciones, realizar operaciones y depositar y retirar fondos en programas de terceros.

Prerrequisitos:

• Necesitas hacer un depósito de cualquier monto en tu Spot Wallet para activar tu cuenta

• Verificación de identidad completa

• Habilite la autenticación de dos factores (2FA) en su cuenta

Pasos para crear una clave API de Binance:

1. Inicie sesión en su cuenta de Binance y haga clic en el ícono de perfil, luego en [Cuenta].

2. Vaya a [Administración de API] y luego haga clic en [Crear API].

3. Seleccione su tipo de clave API preferida:

   • Claves API generadas por el sistema (cifrado simétrico HMAC): recibirá la clave API y la clave secreta.

   • Claves API autogeneradas (cifrado asimétrico Ed25519 o RSA): recibirás una clave API, pero deberás crear tu propio par de claves pública-privada.

4. Ingrese una etiqueta/nombre para su clave API.

5. Verifique con sus dispositivos 2FA y claves de acceso.

6. Su clave API ya está creada.

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

Integración con Claude Desktop

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

• Escritorio de Claude

Luego construya el servidor usando el siguiente comando:

npm run build  

Para agregar este servidor MCP a Claude Desktop:

Cree o edite el archivo de configuración de Claude Desktop en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Agregue 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úrese de pasar la ubicación correcta del archivo index.js en el campo args .

Reinicie Claude Desktop para que los cambios surtan efecto.

Uso (para conectar un HOST MCP que no sea Claude)

Iniciar el servidor

Para iniciar el servidor MCP, ejecute:

npm start  # or node index.js

Funciones

Funciones de la API de Binance

1. Obtener información de la cuenta de Binance - binanceAccountInfo

   Recupera información completa sobre su cuenta de Binance, incluidos saldos, permisos comerciales y estado de la cuenta.

2. Obtener una instantánea de la cuenta de Binance - binanceAccountSnapshot

   Obtén un resumen del estado de tu cuenta de Binance, incluyendo información sobre el precio actual de BTC. Incluye el historial de los últimos 30 días.

3. Consultar el libro de órdenes de Binance - binanceOrderBook

   {
       "symbol": "BTCUSDT"
   }

   Recupera el libro de órdenes actual para un par comercial específico, mostrando órdenes de compra y venta disponibles hasta 50 niveles de profundidad.

4. Realizar una orden de mercado al contado - binanceSpotPlaceOrder

   {
       "symbol": "BTCUSDT",
       "side": "BUY",
       "quantity": 0.001,
       // OR
       "quoteOrderQty": 100
   }

   Coloca una orden de mercado con ejecución inmediata al mejor precio disponible. Use quantity para especificar la cantidad del activo base o quoteOrderQty para especificar la cantidad en la divisa cotizada. Ideal para órdenes pequeñas.

5. Realizar una orden TWAP - binanceTimeWeightedAveragePriceFutureAlgo

   {
       "symbol": "BTCUSDT",
       "side": "BUY",
       "quantity": 1.0,
       "duration": 3600
   }

   Coloca una orden de Precio Promedio Ponderado en el Tiempo (TWAP) que se ejecuta gradualmente durante un período específico para minimizar el impacto en el mercado. Es adecuada para órdenes grandes que, de lo contrario, podrían causar movimientos de precio significativos.

Protocolo de Contexto Modelo (MCP)

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto diseñado para optimizar la interacción de las aplicaciones 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 del MCP:

• Estandarización : define un enfoque unificado para las interacciones de las aplicaciones.

• Eficiencia : reduce la sobrecarga computacional y mejora la velocidad de las transacciones.

• Interoperabilidad : admite la integración entre múltiples plataformas y ecosistemas blockchain.

Manejo de errores

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

• Fondos insuficientes en la billetera

• Dirección de destinatario no válida

• Congestión de la red o problemas de RPC

• Errores de autenticación de la API de Binance

• Restricciones de límites comerciales

Licencia

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

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