MantraChain

Interaja com a blockchain MantraChain (Cosmos SDK).

Documentação

Servidor MCP MantraChain

Um servidor Model Context Protocol (MCP) para interagir com a blockchain MantraChain (Cosmos SDK). Este servidor fornece ferramentas para enviar tokens, delegar a validadores, consultar saldos e muito mais usando o protocolo MCP.

Recursos

Enviar tokens para outros endereços (transferência bancária)
Delegar tokens a validadores (staking)
Consultar saldos de contas
Obter informações de validadores
Assinar e transmitir transações arbitrárias
Configurar mnemônico e rede por meio de variáveis de ambiente
Escolher entre testnet Dukong e Mainnet
Suporta modos de transporte stdio e HTTP+SSE

Ferramentas Disponíveis

Operações Bancárias

bank-send: Enviar tokens para outro endereço (suporta múltiplas moedas por transação)
get-balance: Obter saldo de um endereço (padrão: seu próprio endereço se nenhum for fornecido)
get_evm_balance: Obter saldo de token nativo (OM) para um endereço EVM
get_token_balance: Obter saldo de token ERC20 para um endereço
get_nft_balance: Obter contagem de NFTs ERC721 para um endereço de uma coleção
get_erc1155_balance: Obter saldo de token ERC1155 para um ID de token específico
get_address_from_mnemonic: Obter endereço EVM derivado do mnemônico

Operações de Staking

delegate: Delegar/Apostar tokens para um validador
undelegate: Desdelegar/Retirar tokens de um validador
claim-rewards: Reivindicar recompensas para um validador específico
get-validators: Obter todos os validadores
get-delegations: Obter informações atuais de staking para um endereço
get-available-rewards: Obter todas as recompensas disponíveis para um endereço

Operações de Rede

get-account-info: Obter informações atuais da conta
get-block-info: Obter informações de bloco do RPC Cosmos (cometbft)
get-block-info-evm: Obter informações de bloco do RPC EVM
query-network: Executar uma consulta genérica de rede nas APIs da cadeia

Operações IBC

ibc-transfer: Enviar tokens via transferência IBC

Operações de Contratos Inteligentes

cosmwasm-contract-query: Consultar um contrato inteligente CosmWasm (somente leitura)
cosmwasm-contract-execute: Executar uma função em um contrato CosmWasm (alteração de estado)
read_evm_contract: Ler dados de um contrato EVM (função view/pure)
write_evm_contract: Escrever dados em um contrato EVM (função de alteração de estado)
deploy_evm_contract: Implantar um novo contrato EVM
is_contract: Verificar se um endereço é um contrato ou EOA

Operações DEX

dex-get-pools: Obter todos os pools de liquidez disponíveis do DEX
dex-find-routes: Encontrar rotas de swap disponíveis entre dois tokens
dex-simulate-swap: Simular um swap de token para obter o resultado esperado sem executá-lo
dex-swap: Executar um swap de token no DEX com proteção contra slippage

Operações de Transação

sign-and-broadcast: Assinar e transmitir uma transação Cosmos genérica
get_transaction: Obter informações detalhadas sobre uma transação EVM específica por hash
get_transaction_receipt: Obter recibo de transação EVM por hash
estimate_gas: Estimar custo de gás para uma transação
transfer_om: Transferir tokens nativos (OM) via EVM
transfer_erc20: Transferir tokens ERC20 para outro endereço
approve_token_spending: Aprovar outro endereço para gastar seus tokens ERC20
transfer_nft: Transferir um NFT ERC721 para outro endereço
transfer_erc1155: Transferir tokens ERC1155 para outro endereço
transfer_token: Transferir tokens ERC20 para um endereço

Recursos Disponíveis

networks://all: Recurso JSON mostrando todas as redes disponíveis com suas configurações
openapi://{networkName}: Especificação OpenAPI/Swagger para a rede especificada

Executando o Servidor

O servidor pode ser executado em dois modos:

Modo Stdio (Padrão): Comunica-se por entrada/saída padrão. Este é o modo padrão ao executar o servidor diretamente ou via npx.
```
# Using installed package
mantrachain-mcp

# Using npx
npx -y mantrachain-mcp@latest
```

Modo HTTP Transmissível: Executa um servidor HTTP na porta 3000, comunicando-se via Server-Sent Events (SSE). Ative este modo usando o sinalizador --http ou os scripts npm dedicados.

# Using installed package
mantrachain-mcp --http

# Using npx
export MNEMONIC="YOUR_MNEMONIC"
export CUSTOM_NETWORKS="YOUR_CUSTOM_NETWORKS_JSON"
npx -y mantrachain-mcp@latest -- --http

Configuração MCP

Instalação via Smithery

Para instalar o Servidor MCP MantraChain para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @allthatjazzleo/mantrachain-mcp --client claude

Para integrar com aplicativos clientes MCP, adicione a configuração do servidor ao seu arquivo de configuração do cliente MCP:

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mantrachain-mcp@latest"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC",
        "CUSTOM_NETWORKS": "{\"my-custom-net\":{\"rpcEndpoint\":\"https://rpc.custom-network.io\",\"apiEndpoint\":\"https://api.custom-network.io\",\"chainId\":\"my-custom-net-1\",\"prefix\":\"custom\",\"denom\":\"ucustom\",\"gasPrice\":\"0.01\",\"isMainnet\":false}}"
      }
    }
  }
}

Conectando servidor MCP remoto no cline:

{
  "mcpServers": {
    "mantrachain-mcp-sse": {
      "url": "http://localhost:3000/sse",
      "transportType": "sse"
    }
  }
}

Se você compilar o pacote localmente em vez de globalmente

Após compilar o pacote, você pode executá-lo diretamente do diretório de compilação. Certifique-se de substituir your_path pelo caminho real do seu diretório de compilação.

npm run build

Então, você pode usar a seguinte configuração:

{
  "mcpServers": {
    "mantrachain-mcp": {
      "command": "node",
      "args": [
        "your_path/mantrachain-mcp/build/index.js"
      ],
      "env": {
        "MNEMONIC": "YOUR_MNEMONIC"
      }
    }
  }
}

Variáveis de Ambiente

MNEMONIC: Obrigatório. A frase-semente mnemônica para a carteira a ser usada.
CUSTOM_NETWORKS: Opcional. String JSON contendo configurações adicionais de rede.