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 mediante el protocolo MCP.

Características

• Enviar tokens a otras direcciones (envío bancario)

• Delegar tokens a validadores (staking)

• Consultar saldos de cuentas

• Obtener información del validador

• Firmar y difundir transacciones arbitrarias

• Configurar mnemónico y red a través de variables de entorno

• Elija entre Dukong testnet y Mainnet

• Admite los modos de transporte stdio y HTTP+SSE

Related MCP server: MCP Blockchain Query Server

Herramientas disponibles

Operaciones bancarias

• bank-send : Envía tokens a otra dirección

• get-balance : obtiene el saldo de una dirección (por defecto, su propia dirección si no se proporciona ninguna)

Operaciones de staking

• delegado : delegar/participar tokens en un validador

• undelegate : anular la delegación/dejar de apostar tokens de un validador

• Claim-rewards : Reclama recompensas para 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 : Obtenga todas las recompensas disponibles para una dirección

Operaciones de red

• get-account-info : Obtener información actual de la cuenta

• get-block-info : Obtener información del bloque

• query-network : ejecuta una consulta de red genérica contra las API de cadena

Operaciones de IBC

• ibc-transfer : envía tokens mediante transferencia IBC

Operaciones de contratos inteligentes

• contract-query : consulta un contrato inteligente ejecutando una función de solo lectura

• contract-execute : ejecuta una función en un contrato inteligente que cambia de estado

Operaciones DEX

• dex-get-pools : Obtenga todos los fondos de liquidez disponibles del DEX

• dex-find-routes : Encuentra rutas de intercambio disponibles entre dos tokens

• dex-simulate-swap : simula un intercambio de tokens para obtener el resultado esperado sin ejecutarlo

• dex-swap : Ejecuta un intercambio de tokens en el DEX con protección contra deslizamientos

Operaciones de transacción

• firmar y difundir : firmar y difundir una transacción genérica

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

Ejecución del servidor

El servidor puede funcionar en dos modos:

1. Modo Stdio (predeterminado): Se comunica mediante 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
   

2. Modo HTTP+SSE: Ejecuta un servidor HTTP en el puerto 3000, comunicándose mediante Eventos Enviados por el Servidor (SSE). Active este modo con el indicador -r o los scripts npm dedicados.

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

   Cuando se ejecuta en modo HTTP, el servidor escucha:

   • GET /sse : establece la conexión SSE.

   • POST /messages?sessionId=<id> : Recibe solicitudes de clientes.

Configuración de MCP

Instalación mediante herrería

Para instalar MantraChain MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Para integrarse con las aplicaciones cliente de MCP, agregue la configuración del servidor a su archivo de configuración de cliente de 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 de un servidor MCP remoto en Cline :

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

Si construye el paquete localmente en lugar de globalmente

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

npm run build

Luego puedes utilizar 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 : Obligatorio. La frase mnemotécnica inicial que la billetera debe usar.

• CUSTOM_NETWORKS : Opcional. Cadena JSON que contiene configuraciones de red adicionales.