Binance MCP Server

Servidor MCP da Binance

Documentação em vários idiomas

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

Um servidor MCP (Model Context Protocol) que fornece ao Claude Code funcionalidades da API de exchange da Binance.

Início Rápido

📹 Tutorial em Vídeo

Assista ao nosso tutorial completo de uso do MCP para começar rapidamente:

Instalação

npm install -g binance-mcp-server

Configuração

Este servidor MCP pode ser usado com várias ferramentas de IA que suportam MCP:

Configuração do MCP

Adicione a seguinte configuração ao seu arquivo de configurações do 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: Defina BINANCE_TESTNET como "true" se quiser usar a testnet da Binance para desenvolvimento e testes.

Configuração com um clique 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

Configuração do Ambiente

Obtendo Chaves de API

Para Testnet (Recomendado para Desenvolvimento):

1. Visite Binance Testnet
2. Crie uma conta testnet (nenhuma verificação real é necessária)
3. Vá para Gerenciamento de API na sua conta testnet
4. Crie uma nova chave de API com permissões de negociação
5. Observação: A testnet usa fundos virtuais - completamente segura para testes

Para Mainnet (Produção):

1. Crie uma conta verificada na Binance
2. Complete a verificação KYC
3. Vá para Gerenciamento de API nas configurações da sua conta
4. Crie uma nova chave de API com as permissões necessárias
5. ⚠️ Aviso: A mainnet usa dinheiro real - tenha muito cuidado!

Configuração

Crie o arquivo .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)

Ferramentas Disponíveis

Dados de Mercado

• get_price - Obter o preço atual do par de negociação
• get_orderbook - Obter dados de profundidade do livro de ordens
• get_klines - Obter dados de K-line/candlestick
• get_24hr_ticker - Obter estatísticas de preço das últimas 24 horas

Conta

• get_account_info - Obter informações da conta e saldos
• get_open_orders - Obter ordens abertas atuais
• get_order_history - Obter ordens históricas

Negociação (Mainnet e Testnet)

• place_order - Colocar uma nova ordem (suporta mainnet e testnet)
• cancel_order - Cancelar uma ordem específica (suporta mainnet e testnet)
• cancel_all_orders - Cancelar todas as ordens abertas (suporta mainnet e testnet)

Exemplos de Uso

Peça ao Claude para:

• "Obter o preço atual do Bitcoin"
• "Mostrar o livro de ordens para ETHUSDT"
• "Verificar o saldo da minha conta"
• "Colocar uma ordem de compra limitada de 0,001 BTC a US$ 50.000"

Segurança

⚠️ Importante:

• Defina BINANCE_TESTNET=true para testes seguros com fundos virtuais
• Defina BINANCE_TESTNET=false ou omita para negociação na mainnet com dinheiro REAL
• A negociação na mainnet exibirá avisos antes de executar ordens

Desenvolvimento

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