Binance MCP Server

Interaja com a API da Binance para visualizar portfólios, converter tokens e executar negociações com impacto mínimo no mercado.

GitHub

Experimente este MCPPatrocinado

Documentação

Binance MCP Server

Visão Geral

O Binance MCP Server é um serviço de backend projetado para interagir com a API da Binance. Ele facilita a interação perfeita com a exchange Binance, permitindo que os usuários visualizem seu portfólio, convertam tokens e executem negociações com impacto mínimo no mercado. O servidor utiliza o framework Model Context Protocol (MCP) para garantir transações seguras, estruturadas e eficientes.

Funcionalidades Principais:

Interagir com a API da exchange Binance para informações de conta e negociação
Exibir composição e valorização do portfólio
Executar conversões inteligentes de tokens com mitigação de impacto no mercado
Processar ordens de mercado e estratégias de negociação algorítmica
Recuperar dados de negociação em tempo real e informações de conta
Implementar transações estruturadas usando o framework Model Context Protocol
Fornecer autenticação segura e gerenciamento de chaves de API para integração com a Binance

Recursos

Requisitos

Antes de configurar o Binance MCP Server, certifique-se de ter o seguinte instalado:

Node.js (v16 ou posterior)
npm ou yarn
Chave e segredo da API da Binance (para integração com a exchange Binance)
Uma chave privada válida de carteira Binance Smart Chain (BSC) (para transações blockchain)

Instalação

Clone o repositório e instale as dependências:

git clone https://github.com/your-repo/binance-mcp-server.git
cd binance-mcp-server
npm install  # or yarn install

Configuração

Para configurar o servidor, crie um arquivo .env no diretório raiz e especifique as seguintes variáveis:

# Binance API Configuration
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here

Criando uma Chave de API da Binance

Antes de usar a integração com a API da Binance, você precisa criar uma chave de API. Isso permite que você se conecte aos servidores da Binance por meio de várias linguagens de programação, obtenha dados da Binance e interaja com aplicativos externos. Você pode visualizar seus dados de carteira e transações, fazer negociações e depositar e retirar fundos em programas de terceiros.

Pré-requisitos:

Você precisa fazer um depósito de qualquer valor na sua Carteira Spot para ativar sua conta
Conclua a verificação de identidade
Ative a autenticação de dois fatores (2FA) na sua conta

Passos para criar uma Chave de API da Binance:

Faça login na sua conta Binance e clique no ícone de perfil, depois em [Conta].
Vá para [Gerenciamento de API] e clique em [Criar API].
Selecione o tipo de chave de API preferido:
- Chaves de API geradas pelo sistema (criptografia simétrica HMAC) - Você receberá a chave de API e a chave secreta.
- Chaves de API autogeradas (criptografia assimétrica Ed25519 ou RSA) - Você receberá uma chave de API, mas precisará criar seu próprio par de chaves pública-privada.
Insira um rótulo/nome para sua chave de API.
Verifique com seus dispositivos 2FA e chaves de acesso.
Sua chave de API foi criada.

Para mais detalhes sobre a API da Binance, consulte a Documentação da API Binance.

Integração com o Claude Desktop

Antes de integrar este servidor MCP com o Claude Desktop, certifique-se de ter o seguinte instalado:

Claude Desktop

Em seguida, compile o servidor usando o seguinte comando:

npm run build

Para adicionar este servidor MCP ao Claude Desktop:

Crie ou edite o arquivo de configuração do Claude Desktop em:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Adicione a seguinte configuração:

{
    "mcpServers": {
        "binance-mcp": {
            "command": "node",
            "args": [
                "/Users/Username/Desktop/binance-mcp/build/index.js"
            ],
            "env": {
                "BINANCE_API_KEY": "BINANCE_API_KEY",
                "BINANCE_API_SECRET": "BINANCE_API_SECRET"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

Certifique-se de passar a localização correta do arquivo index.js no campo args.

Reinicie o Claude Desktop para que as alterações entrem em vigor.

Uso (Para Conectar um HOST MCP diferente do Claude)

Iniciar o Servidor

Para iniciar o servidor MCP, execute:

npm start  # or node index.js

Funções

Funções da API Binance

Obter Informações da Conta Binance - binanceAccountInfo

Recupera informações abrangentes sobre sua conta Binance, incluindo saldos, permissões de negociação e status da conta.
Obter Instantâneo da Conta Binance - binanceAccountSnapshot

Obtém um instantâneo do status da sua conta Binance, incluindo informações atuais do preço do BTC. Inclui histórico dos últimos 30 dias.
Verificar Livro de Ordens da Binance - binanceOrderBook
```
{
    "symbol": "BTCUSDT"
}
```
Recupera o livro de ordens atual para um par de negociação especificado, mostrando ordens de compra e venda disponíveis até 50 níveis de profundidade.
Colocar Ordem de Mercado à Vista - binanceSpotPlaceOrder
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 0.001,
    // OR
    "quoteOrderQty": 100
}
```
Coloca uma ordem de mercado para execução imediata ao melhor preço disponível. Use quantity para especificar a quantidade do ativo base ou quoteOrderQty para especificar a quantidade na moeda de cotação. Adequado para ordens pequenas.
Colocar Ordem TWAP - binanceTimeWeightedAveragePriceFutureAlgo
```
{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "quantity": 1.0,
    "duration": 3600
}
```
Coloca uma ordem de Preço Médio Ponderado por Tempo (TWAP) que é executada gradualmente ao longo de uma duração especificada para minimizar o impacto no mercado. Adequado para ordens grandes que, de outra forma, poderiam causar movimentos significativos de preço.

Model Context Protocol (MCP)

O Model Context Protocol (MCP) é um padrão aberto projetado para melhorar a forma como os aplicativos interagem com modelos de IA e sistemas computacionais baseados em blockchain. O MCP estabelece contexto estruturado que melhora a eficiência de transações automatizadas e aplicativos descentralizados.

Benefícios do MCP:

Padronização: Define uma abordagem unificada para interações de aplicativos.
Eficiência: Reduz a sobrecarga computacional e melhora a velocidade das transações.
Interoperabilidade: Suporta integração em múltiplas plataformas e ecossistemas blockchain.

Tratamento de Erros

Quando uma transação falha, o servidor retorna uma mensagem de erro com detalhes. Verifique os logs do console para obter mais informações de depuração. Cenários de erro comuns incluem:

Fundos insuficientes na carteira
Endereço de destinatário inválido
Congestionamento de rede ou problemas de RPC
Erros de autenticação da API Binance
Restrições de limite de negociação

Licença

Este projeto é de código aberto sob a Licença MIT.

Para contribuições, relatórios de bugs ou solicitações de recursos, envie um problema no GitHub.