Binance MCP Server

Servidor MCP (Model Context Protocol) que le da a Claude (u otro cliente MCP) acceso a la REST API de Binance Spot: consultar precios, velas, balances, y operar — con los retiros desactivados por defecto por seguridad. An MCP server that gives Claude (or any MCP client) access to the Binance Spot REST API: prices, candlesticks, balances, and trading — with withdrawals disabled by default for safety.

!Python !MCP !License

---

🇪🇸 Español

¿Qué es esto?

Un servidor MCP en Python que expone la API de Binance Spot como herramientas (tools) que un modelo como Claude puede invocar en lenguaje natural. Le preguntas "¿a cuánto está el BTC?" o "compra 0.01 ETH" y el modelo llama a la herramienta correspondiente.

Seguridad primero 🔒

Mover dinero con un LLM es delicado, así que el servidor está diseñado a la defensiva:

• Retiros desactivados a nivel de código. withdraw no hace nada salvo que pongas ENABLE_WITHDRAWALS=true y la API key tenga permiso de retiro. La recomendación es no dárselo.
• Testnet por defecto (BINANCE_TESTNET=true): prueba contra el entorno de pruebas de Binance antes de tocar fondos reales.
• Firma HMAC SHA256 en cada request privado, igual que exige Binance.
• Recomendado: crear la API key sin permiso de retiro y con IP whitelist.

Herramientas disponibles

| Herramienta | Tipo | Descripción | |---|---|---| | get_price | pública | Precio actual de un símbolo (BTCUSDT) | | get_24h_stats | pública | Estadísticas 24h: volumen, cambio %, máx/mín | | get_klines | pública | Velas / candlesticks (1m…1w) | | get_order_book | pública | Libro de órdenes (bids/asks) | | get_account | firmada | Balances y permisos de tu cuenta spot | | get_open_orders | firmada | Órdenes abiertas | | get_my_trades | firmada | Tu historial de trades | | place_order | firmada | Crea orden MARKET o LIMIT | | cancel_order | firmada | Cancela una orden por orderId | | cancel_all_orders | firmada | Cancela todas las órdenes de un símbolo | | withdraw | firmada | Retiro (desactivado por defecto) |

Instalación

Requiere uv (gestor de paquetes de Python).

git clone https://github.com/Lubodi-Code/binance-mcp.git
cd binance-mcp
uv sync

Configuración

Copia .env.example a .env y rellena tus claves de Binance:

cp .env.example .env

BINANCE_API_KEY=tu_api_key
BINANCE_API_SECRET=tu_secret
BINANCE_TESTNET=true          # empieza siempre en testnet
ENABLE_WITHDRAWALS=false      # no lo cambies salvo que sepas lo que haces

Para el testnet de spot, genera tus claves en https://testnet.binance.vision

Conectarlo a Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "binance": {
      "command": "uv",
      "args": ["--directory", "/ruta/absoluta/a/binance-mcp", "run", "server.py"],
      "env": {
        "BINANCE_API_KEY": "tu_api_key",
        "BINANCE_API_SECRET": "tu_secret",
        "BINANCE_TESTNET": "true"
      }
    }
  }
}

Reinicia Claude Desktop y pídele, por ejemplo: "¿a cuánto está el BTC y cómo se movió en las últimas 24h?"

---

🇬🇧 English

What is this?

A Python MCP server that exposes the Binance Spot API as tools an LLM like Claude can call from natural language. Ask "what's the BTC price?" or "buy 0.01 ETH" and the model invokes the right tool.

Safety first 🔒

Moving money with an LLM is risky, so the server is defensive by design:

• Withdrawals disabled in code. withdraw is a no-op unless you set ENABLE_WITHDRAWALS=true and the API key has withdraw permission. The recommendation is not to grant it.
• Testnet by default (BINANCE_TESTNET=true): test against Binance's sandbox before touching real funds.
• HMAC SHA256 signing on every private request, as Binance requires.
• Recommended: create the API key without withdraw permission and with an IP whitelist.

Available tools

| Tool | Type | Description | |---|---|---| | get_price | public | Current price of a symbol (BTCUSDT) | | get_24h_stats | public | 24h stats: volume, % change, high/low | | get_klines | public | Candlesticks (1m…1w) | | get_order_book | public | Order book (bids/asks) | | get_account | signed | Spot account balances & permissions | | get_open_orders | signed | Open orders | | get_my_trades | signed | Your trade history | | place_order | signed | Create a MARKET or LIMIT order | | cancel_order | signed | Cancel an order by orderId | | cancel_all_orders | signed | Cancel all orders for a symbol | | withdraw | signed | Withdraw (disabled by default) |

Install

Requires uv.

git clone https://github.com/Lubodi-Code/binance-mcp.git
cd binance-mcp
uv sync
cp .env.example .env   # then fill in your keys

Run

uv run server.py

Then wire it into Claude Desktop's claude_desktop_config.json (see the Spanish section above for the exact config block).

---

⚠️ Disclaimer

Este proyecto es educativo. Operar con criptomonedas conlleva riesgo financiero. El autor no se hace responsable de pérdidas. Úsalo bajo tu propia responsabilidad y empieza siempre en testnet.

This project is for educational purposes. Crypto trading carries financial risk. The author is not liable for any losses. Use at your own risk and always start on testnet.

Stack

Python 3.10+ · MCP SDK (FastMCP) · httpx · uv

License

MIT — see LICENSE.