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

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
yarn install  # or npm 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:

Inicie sesión en su cuenta de Binance y haga clic en el ícono de perfil, luego en [Cuenta].
Vaya a [Administración de API] y luego haga clic en [Crear API].
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.
Ingrese una etiqueta/nombre para su clave API.
Verifique con sus dispositivos 2FA y claves de acceso.
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 (para múltiples servidores MCP)

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

Escritorio de Claude

Utilice el siguiente comando desde la raíz del monorepo para construir todos los servidores MCP.

yarn build

Configurar Claude Desktop

Cada servidor MCP tiene su propia configuración. Para integrar un servidor MCP individual:

Navegue a la carpeta del servidor MCP (por ejemplo, packages/binance-spot-mcp ).
Abra su archivo config.example.json .
Utilice el contenido de este archivo para crear una entrada dentro de su configuración de Claude Desktop:

Ubicación del archivo de configuración de escritorio de Claude

Plataforma	Camino
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Ventanas	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Ejemplo de entrada de configuración

Así es como podría verse un servidor MCP ( binance-spot-mcp ):

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

Nota: asegúrese de reemplazar la ruta args con la ubicación real de su build/index.js y copie los valores env del config.example.json de ese servidor.

Reinicie Claude Desktop para que la nueva configuración surta efecto.

Uso (para conectar hosts MCP distintos de Claude)

Tiene tres opciones para iniciar sus servidores MCP según sus necesidades:

Opción 1: Compilar y luego iniciar todos los servidores MCP

yarn build     # Step 1: Build all packages
yarn start     # Step 2: Start all MCP servers concurrently

Opción 2: Construir e iniciar todos los servidores MCP en un solo paso

yarn server    # This builds and runs all MCP servers in one go

Opción 3: Ejecutar un servidor MCP específico

Utilice el siguiente comando para ejecutar un servidor individual:

yarn server:<mcp-server-name>

🔸 Ejemplo:

yarn server:binance-spot-mcp

Funciones

Funciones de la API de Binance

Obtener información de la cuenta de Binance - binanceAccountInfoRecupera información completa sobre su cuenta de Binance, incluidos saldos, permisos comerciales y estado de la cuenta.
Obtener una instantánea de la cuenta de Binance - binanceAccountSnapshotObté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.
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.
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.
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 .

Binance MCP Server

Integrations