Binance MCP Server

Servidor MCP de Binance

Documentación multilingüe

• English (actual)
• 中文
• 日本語

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

Inicio rápido

📹 Tutorial en video

Mira nuestro tutorial completo de uso de MCP para comenzar rápidamente:

Instalación

npm install -g binance-mcp-server

Configuración

Este servidor MCP se puede utilizar con varias herramientas de IA que admiten MCP:

Configuración de MCP

Agrega la siguiente configuración a tu archivo de ajustes de MCP:

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

Nota: Establece BINANCE_TESTNET en "true" si deseas usar la red de pruebas de Binance para desarrollo y pruebas.

Configuración con un clic usando Claude Code

claude mcp add binance --env BINANCE_API_KEY=YOUR_API_KEY --env BINANCE_API_SECRET=YOUR_API_SECRET --env BINANCE_TESTNET=false -- npx -y binance-mcp-server

Configuración del entorno

Obtención de claves API

Para Testnet (Recomendado para desarrollo):

1. Visita Binance Testnet
2. Crea una cuenta de testnet (no se requiere verificación real)
3. Ve a Gestión de API en tu cuenta de testnet
4. Crea una nueva clave API con permisos de trading
5. Nota: Testnet usa fondos virtuales: completamente seguro para pruebas

Para Mainnet (Producción):

1. Crea una cuenta verificada en Binance
2. Completa la verificación KYC
3. Ve a Gestión de API en la configuración de tu cuenta
4. Crea una nueva clave API con los permisos requeridos
5. ⚠️ Advertencia: Mainnet usa dinero real: ¡ten mucho cuidado!

Configuración

Crea el archivo .env:

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here
BINANCE_TESTNET=true  # Set to false for mainnet (REAL money)

Herramientas disponibles

Datos de mercado

• get_price - Obtén el precio actual de un par de trading
• get_orderbook - Obtén datos de profundidad del libro de órdenes
• get_klines - Obtén datos de velas K-line/velas japonesas
• get_24hr_ticker - Obtén estadísticas de precios de 24 horas

Cuenta

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

Trading (Mainnet y Testnet)

• place_order - Coloca una nueva orden (admite tanto mainnet como testnet)
• cancel_order - Cancela una orden específica (admite tanto mainnet como testnet)
• cancel_all_orders - Cancela todas las órdenes abiertas (admite tanto mainnet como testnet)

Ejemplos de uso

Pídele a Claude que:

• "Obtén el precio actual de Bitcoin"
• "Muéstrame el libro de órdenes para ETHUSDT"
• "Consulta el saldo de mi cuenta"
• "Coloca una orden de compra limitada de 0.001 BTC a $50,000"

Seguridad

⚠️ Importante:

• Establece BINANCE_TESTNET=true para pruebas seguras con fondos virtuales
• Establece BINANCE_TESTNET=false u omítelo para trading en mainnet con dinero REAL
• El trading en mainnet mostrará advertencias antes de ejecutar órdenes

Desarrollo

npm run build    # Compile TypeScript
npm run dev      # Development mode
npm run lint     # Run linting