Binance MCP Server

Documentació multilingüe

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

Un servidor Model Context Protocol (MCP) que proporciona a Claude Code funcionalitat de l’API d’intercanvi Binance.

Inici ràpid

Instal·lació

npm install -g binance-mcp-server

Configuració

Aquest servidor MCP es pot utilitzar amb diverses eines d’IA que admeten MCP:

Configuració MCP

Afegeix la configuració següent al fitxer de configuració MCP:

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

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

Configuració de l'entorn

Obtenir claus API

Per al Testnet (recomanat per al desenvolupament):

1. Visita Binance Testnet
2. Crea un compte de testnet (no es requereix verificació real)
3. Accedeix a la Gestió d’API al teu compte de testnet
4. Crea una nova clau API amb permisos de negociació
5. Nota: el Testnet utilitza fons virtuals - completament segur per a proves

Per al Mainnet (producció):

1. Crea un compte verificat a Binance
2. Completa la verificació KYC
3. Accedeix a la Gestió d’API a la configuració del teu compte
4. Crea una nova clau API amb els permisos requerits
5. ⚠️ Avís: el Mainnet utilitza diners reals - tingues molt cura!

Configuració

Crea un fitxer .env:

BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here
BINANCE_TESTNET=true  # Estableix a false per al mainnet (diners reals)

Eines disponibles

Dades de mercat

• get_price - Obtén el preu actual per a una parella de comerç
• get_orderbook - Obtén dades de profunditat de l’ordre book
• get_klines - Obtén dades de línies K/candlestick
• get_24hr_ticker - Obtén estadístiques de preu de 24 hores

Compte

• get_account_info - Obtén informació del compte i balanç
• get_open_orders - Obtén les comandes obertes actuals
• get_order_history - Obtén l’historial de comandes

Negoci (Mainnet & Testnet)

• place_order - Realitza una nova comanda (suporta mainnet i testnet)
• cancel_order - Cancel·la una comanda específica (suporta mainnet i testnet)
• cancel_all_orders - Cancel·la totes les comandes obertes (suporta mainnet i testnet)

Exemples d'ús

Demana a Claude que:

• "Obté el preu actual de Bitcoin"
• "Mostra'm l’ordre book per a ETHUSDT"
• "Comprova el meu balanç de compte"
• "Realitza una comanda de compra limit per a 0.001 BTC a $50,000"

Seguretat

⚠️ Important:

• Estableix BINANCE_TESTNET=true per a proves segures amb fons virtuals
• Estableix BINANCE_TESTNET=false o omet per a negociació en mainnet amb DINERS REALS
• La negociació en mainnet mostrará avisos abans d'executar comandes

Desenvolupament

npm run build    # Compila TypeScript
npm run dev      # Mode de desenvolupament
npm run lint     # Executa linting

Licència

MIT License