BSC MultiSend MCP

Realizar transferências em massa de tokens BNB e BEP20 na BNB Smart Chain (BSC).

Documentação

BSC MultiSend MCP

Um servidor MCP que permite que agentes realizem transferências em massa de BNB e tokens BEP20 na BSC.

License Node.js Status

Recursos

  • Ferramenta distributeNative: Envia BNB para múltiplos endereços em uma única transação.
    • Parâmetros:
      • receivers: Matriz de endereços BSC que receberão BNB.
      • amounts: Matriz de quantidades de BNB (ex.: 0,1 BNB) a enviar, somadas automaticamente para o total.
    • Converte automaticamente as quantidades para wei e lida com a estimativa de gás.
  • Ferramenta distributeToken: Envia tokens BEP20 para múltiplos endereços.
    • Parâmetros:
      • tokenAddress: Endereço do contrato do token BEP20.
      • receivers: Matriz de endereços BSC que receberão os tokens.
      • amounts: Matriz de quantidades de tokens (ex.: 100,5 tokens).
    • Consulta as casas decimais do token, verifica a permissão (allowance) e aprova automaticamente, se necessário.

Pré-requisitos

  • Node.js: Versão 18 ou superior.
  • pnpm: Para instalar as dependências.
  • Carteira BNB Smart Chain: Uma carteira com BNB suficiente para gás e tokens para distribuição.
  • Endpoint RPC da BSC: Acesso a um nó da BSC (ex.: https://bsc-dataseed.binance.org/).

Instalação

  1. Clone o repositório:

    git clone https://github.com/kukapay/bsc-multisend-mcp.git
    cd bsc-multisend-mcp
    
  2. Instale as dependências:

    pnmp install
    
  3. Configure o cliente MCP:

    Arquivo de configuração do Claude Desktop como referência:

    {
       "mcpServers": {
           "BSC MultiSend": {
               "command": "node",
               "args": [ "/path/to/bsc-multisend-mcp/index.js" ],
               "env": { "PRIVATE_KEY": "your-private-key" }               
           }
       }
    }
    

    Substitua /path/to/bsc-multisend-mcp pelo caminho real da sua instalação e your-private-key pela chave privada da sua carteira BSC.

Uso

O servidor oferece duas ferramentas — distributeNative e distributeToken — para distribuição em massa de tokens.

distributeNative

Finalidade: Distribui BNB para múltiplos endereços em uma única transação.

Exemplo de Prompt:

I want to send 0.1 BNB to 0xRecipient1 and 0.2 BNB to 0xRecipient2 on BSC.

Resposta Esperada:

BNB distribution successful. Tx Hash: 0x...

distributeToken

Finalidade: Distribui tokens BEP20 para múltiplos endereços. Consulta as casas decimais do token, verifica a permissão do contrato, aprova o contrato se necessário e executa a transferência.

Exemplo de Prompt:

Send tokens to the following addresses on BSC using the token contract at 0xTokenAddress:
- 0xRecipient1: 100.5 tokens
- 0xRecipient2: 200 tokens
- 0xRecipient3: 50.75 tokens
- 0xRecipient4: 150 tokens
- 0xRecipient5: 75.25 tokens

Resposta Esperada:

Token distribution successful. Tx Hash: 0x...

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.