MantraChain

Interactúa con la blockchain de MantraChain (Cosmos SDK).

Documentación

Servidor MCP de MantraChain

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la blockchain de MantraChain (Cosmos SDK). Este servidor proporciona herramientas para enviar tokens, delegar a validadores, consultar saldos y más, utilizando el protocolo MCP.

Características

Enviar tokens a otras direcciones (transferencia bancaria)
Delegar tokens a validadores (staking)
Consultar saldos de cuentas
Obtener información de validadores
Firmar y transmitir transacciones arbitrarias
Configurar mnemónico y red mediante variables de entorno
Elegir entre la red de pruebas Dukong y la red principal
Soporta modos de transporte stdio y HTTP+SSE

Herramientas Disponibles

Operaciones Bancarias

bank-send: Enviar tokens a otra dirección (soporta múltiples monedas por transacción)
get-balance: Obtener el saldo de una dirección (por defecto usa tu propia dirección si no se proporciona ninguna)
get_evm_balance: Obtener el saldo de token nativo (OM) para una dirección EVM
get_token_balance: Obtener el saldo de tokens ERC20 para una dirección
get_nft_balance: Obtener el conteo de NFTs ERC721 para una dirección de una colección
get_erc1155_balance: Obtener el saldo de tokens ERC1155 para un ID de token específico
get_address_from_mnemonic: Obtener la dirección EVM derivada del mnemónico

Operaciones de Staking

delegate: Delegar/Apostar tokens a un validador
undelegate: Desdelegar/Retirar tokens de un validador
claim-rewards: Reclamar recompensas de un validador específico
get-validators: Obtener todos los validadores
get-delegations: Obtener información de staking actual para una dirección
get-available-rewards: Obtener todas las recompensas disponibles para una dirección

Operaciones de Red

get-account-info: Obtener información de cuenta actual
get-block-info: Obtener información de bloque desde RPC de Cosmos (cometbft)
get-block-info-evm: Obtener información de bloque desde RPC de EVM
query-network: Ejecutar una consulta de red genérica contra las APIs de la cadena

Operaciones IBC

ibc-transfer: Enviar tokens mediante transferencia IBC

Operaciones de Contratos Inteligentes

cosmwasm-contract-query: Consultar un contrato inteligente CosmWasm (solo lectura)
cosmwasm-contract-execute: Ejecutar una función en un contrato CosmWasm (cambio de estado)
read_evm_contract: Leer datos de un contrato EVM (función view/pure)
write_evm_contract: Escribir datos en un contrato EVM (función de cambio de estado)
deploy_evm_contract: Desplegar un nuevo contrato EVM
is_contract: Verificar si una dirección es un contrato o EOA

Operaciones DEX

dex-get-pools: Obtener todos los pools de liquidez disponibles del DEX
dex-find-routes: Encontrar rutas de intercambio disponibles entre dos tokens
dex-simulate-swap: Simular un intercambio de tokens para obtener el resultado esperado sin ejecutarlo
dex-swap: Ejecutar un intercambio de tokens en el DEX con protección contra deslizamiento

Operaciones de Transacciones

sign-and-broadcast: Firmar y transmitir una transacción genérica de Cosmos
get_transaction: Obtener información detallada de una transacción EVM específica por hash
get_transaction_receipt: Obtener el recibo de transacción EVM por hash
estimate_gas: Estimar el costo de gas para una transacción
transfer_om: Transferir tokens nativos (OM) mediante EVM
transfer_erc20: Transferir tokens ERC20 a otra dirección
approve_token_spending: Aprobar que otra dirección gaste tus tokens ERC20
transfer_nft: Transferir un NFT ERC721 a otra dirección
transfer_erc1155: Transferir tokens ERC1155 a otra dirección
transfer_token: Transferir tokens ERC20 a una dirección

Recursos Disponibles

networks://all: Recurso JSON que muestra todas las redes disponibles con su configuración
openapi://{networkName}: Especificación OpenAPI/Swagger para la red especificada

Ejecutar el Servidor

El servidor puede ejecutarse en dos modos:

Modo Stdio (Predeterminado): Se comunica a través de entrada/salida estándar. Este es el modo predeterminado al ejecutar el servidor directamente o mediante npx.
```
# Using installed package
mantrachain-mcp

# Using npx
npx -y mantrachain-mcp@latest
```
Modo HTTP Transmisible: Ejecuta un servidor HTTP en el puerto 3000, comunicándose mediante Eventos Enviados por el Servidor (SSE). Activa este modo usando la bandera --http o los 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
```

Configuración de MCP

Instalación mediante Smithery

Para instalar el Servidor MCP de MantraChain para Claude Desktop automáticamente mediante Smithery:

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

Para integrarse con aplicaciones cliente MCP, agrega la configuración del servidor a tu archivo de configuración del 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}}"
      }
    }
  }
}

Conexión del servidor MCP remoto en cline:

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

Si compilas el paquete localmente en lugar de globalmente

Después de compilar el paquete, puedes ejecutarlo directamente desde el directorio de compilación. Asegúrate de reemplazar your_path con la ruta real a tu directorio de compilación.

npm run build

Luego, puedes usar la siguiente configuración:

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

Variables de Entorno

MNEMONIC: Requerido. La frase semilla mnemónica para la billetera a utilizar.
CUSTOM_NETWORKS: Opcional. Cadena JSON que contiene configuraciones de red adicionales.