Servidor MCP de Binance

Documentación multilingüe

• Inglés (actual)
• 中文
• 日本語

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona Claude Code con la funcionalidad de la API de intercambio de Binance.

Inicio Rápido

Instalación

npm install -g binance-mcp-server

Configuración

Este servidor MCP puede ser utilizado con varias herramientas de IA que soportan MCP:

Configuración MCP

Añada la siguiente configuración a su archivo de configuración MCP:

Claude Escritorio: claude_desktop_config.json
Cursor: .cursor/mcp_config.json

{ "mcpServers": { "binance": { "command": "npx", "args": ["binance-mcp-server"], "env": { "BINANCE_API_KEY": "tu_clave_api", "BINANCE_API_SECRET": "your_api_secret", "BINANCE_TESTNET": "true" } } } }

Configuración del entorno

Obtención de claves de API

Para Testnet (Recomendado para Desarrollo):

1. Visite Binance Testnet
2. Cree una cuenta testnet (no requiere verificación real)
3. Vaya a Gestión de API en su cuenta testnet
4. Crear una nueva clave API con permisos de negociación
5. Nota: Testnet utiliza fondos virtuales - completamente seguro para pruebas

Para Mainnet (Producción):

1. Crear una cuenta verificada en Binance
2. Completa la verificación KYC
3. Vaya a Gestión de API en la configuración de su cuenta
4. Crear una nueva clave de API con los permisos necesarios
5. ⚠️ Advertencia: Mainnet utiliza dinero real - ¡ten mucho cuidado!

Configuración

Cree un archivo .env:

BINANCE_API_KEY=tu_clave_api_aquí BINANCE_API_SECRET=tu_secreto_api_aquí BINANCE_TESTNET=true # Establecer en false para mainnet (dinero REAL)

Herramientas disponibles

Datos de mercado

• get_price - Obtener el precio actual del par de negociación
• get_orderbook - Obtener datos de profundidad del libro de órdenes
• get_klines - Obtener datos K-line/candlestick
• get_24hr_ticker - Obtener estadísticas de precios de 24 horas

Cuenta

• get_account_info - Obtener información de la cuenta y saldos
• get_open_orders - Obtener órdenes abiertas actuales
• get_order_history - Obtener órdenes históricas

Negociación (Mainnet y Testnet)

• place_order - Colocar una nueva orden (soporta mainnet y testnet)
• cancel_order - Cancelar una orden específica (soporta mainnet y testnet)
• cancel_all_orders - Cancelar todas las órdenes abiertas (para mainnet y testnet)

Ejemplos de uso

Pedir a Claude que:

• "Obtener el precio actual de Bitcoin"
• "Mostrarme el libro de órdenes de ETHUSDT"
• "Compruebe el saldo de mi cuenta
• "Coloque una orden de compra limitada de 0,001 BTC a 50.000 $

Seguridad

⚠️ Importante:

• Establezca BINANCE_TESTNET=true para realizar pruebas seguras con fondos virtuales
• Establezca BINANCE_TESTNET=false u omitir para el comercio mainnet con dinero REAL
• Mainnet trading mostrará advertencias antes de ejecutar órdenes

Desarrollo

npm run build # Compilar TypeScript npm run dev # Modo desarrollo npm run lint # Ejecutar linting

Licencia

Licencia MIT