GenLayer CLI MCP

Servidor MCP para agentes de IA que necesitan trabajar con proyectos de GenLayer.

Expone:

genlayer: acceso completo a la CLI de GenLayer
genvm_lint: acceso a genvm-lint
genlayer_deploy: despliega contratos con genlayer-js
check_tools: verifica la disponibilidad de herramientas locales y la configuración de la clave privada

El servidor utiliza transporte stdio y ejecuta comandos con spawn(command, args).

Requisitos

Node.js 18+
GenLayer CLI disponible en PATH
GenVM linter disponible en PATH

Instala las herramientas externas:

npm install -g genlayer
py -3.12 -m pip install genvm-linter

Compruébalas:

genlayer --version
genvm-lint --version

Configuración de MCP

Si este paquete se publica en npm:

{
  "mcpServers": {
    "genlayer-cli": {
      "command": "npx",
      "args": ["-y", "genlayer-cli-mcp"],
      "env": {
        "GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Si se ejecuta desde este repositorio:

{
  "mcpServers": {
    "genlayer-cli": {
      "command": "node",
      "args": ["E:\\genlayer-cli-mcp\\dist\\index.js"],
      "env": {
        "GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Nombres de variables de entorno aceptados para la clave privada:

GENLAYER_PRIVATE_KEY
GENLAYER_PRV_KEY
GENLAYER_PRIVKEY
PRIVATE_KEY

La clave privada puede ser 0x más 64 caracteres hexadecimales o 64 caracteres hexadecimales sin formato. Si la clave configurada falta o no es válida, genlayer_deploy genera una nueva clave privada y despliega con ella en la misma llamada de herramienta. Cuando se genera una nueva clave, la respuesta la incluye para que puedas guardarla.

Desarrollo local

cd E:\genlayer-cli-mcp
npm install
npm run build
npm run smoke

Ejecuta el servidor:

node E:\genlayer-cli-mcp\dist\index.js

Empaqueta localmente:

npm pack

Publica en npm:

npm login
npm publish --access public

Herramientas

`check_tools`

Comprueba node, genlayer, python, genvm-lint y la configuración de la clave privada.

Ejemplo de prompt para IA:

Use MCP tool check_tools from genlayer-cli.

`genlayer`

Ejecuta genlayer <args...> con acceso completo al comando.

Ejemplo:

{
  "args": ["--version"]
}

Ejemplo de despliegue a través de la CLI sin procesar:

{
  "args": [
    "deploy",
    "--contract",
    "E:\\path\\to\\contract.py",
    "--rpc",
    "http://localhost:4000/api"
  ],
  "timeoutMs": 120000
}

`genvm_lint`

Ejecuta genvm-lint <args...>.

Ejemplo:

{
  "args": ["check", "E:\\path\\to\\contract.py"],
  "timeoutMs": 120000
}

`genlayer_deploy`

Despliega un Contrato Inteligente a través de genlayer-js.

Esta es la herramienta de despliegue recomendada para agentes de IA porque maneja el respaldo de la clave privada:

Usa privateKey de la entrada de la herramienta si es válida.
De lo contrario, usa la clave privada de la variable de entorno de configuración de MCP si es válida.
De lo contrario, genera una nueva clave privada.
Despliega con la clave privada seleccionada/generada inmediatamente.

Ejemplo:

{
  "contractPath": "E:\\path\\to\\contract.py",
  "chain": "localnet",
  "rpcUrl": "http://localhost:4000/api",
  "autoFundLocalnet": true,
  "waitForReceipt": true,
  "receiptStatus": "ACCEPTED",
  "timeoutMs": 120000
}

Campos opcionales:

{
  "privateKey": "0x...",
  "args": [],
  "kwargs": {},
  "cwd": "E:\\project",
  "leaderOnly": false,
  "consensusMaxRotations": 5,
  "initializeConsensus": true,
  "fundAmount": 10,
  "receiptRetries": 50,
  "receiptIntervalMs": 5000,
  "exposePrivateKey": false
}

Cadenas (chains) soportadas:

localnet
studionet
testnetAsimov
testnetBradbury

Ejemplos de configuración de agentes

Utiliza la misma definición de servidor MCP para agentes de codificación que admitan MCP sobre stdio. Reemplaza la clave privada con tu propia clave de testnet/local, o déjala inválida si deseas que genlayer_deploy genere una clave nueva durante el despliegue.

Codex

Añade este servidor MCP a tu configuración de MCP de Codex:

{
  "mcpServers": {
    "genlayer-cli": {
      "command": "npx",
      "args": ["-y", "genlayer-cli-mcp"],
      "env": {
        "GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Prompt sugerido para Codex:

Use MCP tool check_tools from genlayer-cli and tell me whether deploy can use the configured private key.

Then lint my GenLayer contract with genvm_lint.

If lint passes, deploy it with genlayer_deploy using:
{
  "contractPath": "E:\\path\\to\\contract.py",
  "chain": "localnet",
  "rpcUrl": "http://localhost:4000/api",
  "autoFundLocalnet": true,
  "waitForReceipt": true,
  "receiptStatus": "ACCEPTED"
}

Antigravity

Añade el servidor MCP en la configuración de MCP de Antigravity:

{
  "mcpServers": {
    "genlayer-cli": {
      "command": "npx",
      "args": ["-y", "genlayer-cli-mcp"],
      "env": {
        "GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
      }
    }
  }
}

Prompt sugerido para Antigravity:

Use the genlayer-cli MCP server.

First call check_tools.
Then run genvm_lint on:
{
  "args": ["check", "E:\\path\\to\\contract.py"]
}

If the contract is valid, call genlayer_deploy. If the configured MCP private key is invalid, let the MCP tool generate a new private key and deploy with it automatically.

Claude Code

Añade el servidor con el comando de adición de MCP de Claude Code:

claude mcp add genlayer-cli -- npx -y genlayer-cli-mcp

Si tu configuración de Claude Code admite variables de entorno en la configuración de MCP, añade:

{
  "GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}

Comando alternativo de fuente local:

claude mcp add genlayer-cli -- node E:\genlayer-cli-mcp\dist\index.js

Prompt sugerido para Claude Code:

Use the genlayer-cli MCP server.

1. Call check_tools.
2. Run genvm_lint for E:\path\to\contract.py.
3. If lint succeeds, deploy with genlayer_deploy.
4. If the private key in MCP config is missing or invalid, generate a new private key and deploy with that generated key in the same tool call.

Arguments:
{
  "contractPath": "E:\\path\\to\\contract.py",
  "chain": "localnet",
  "rpcUrl": "http://localhost:4000/api",
  "autoFundLocalnet": true,
  "waitForReceipt": true,
  "receiptStatus": "ACCEPTED"
}

Seguridad

Este servidor MCP expone intencionalmente el acceso completo a los comandos de GenLayer. Los agentes de IA pueden ejecutar comandos que cambian el estado, como deploy, write, up, stop e init.

No pongas una clave privada de mainnet en la configuración de MCP a menos que confíes en el cliente de IA y en todas las herramientas habilitadas.

genlayer-cli-mcp

GenLayer CLI MCP

Requisitos

Configuración de MCP

Desarrollo local

Herramientas

`check_tools`

`genlayer`

`genvm_lint`

`genlayer_deploy`

Ejemplos de configuración de agentes

Codex

Antigravity

Claude Code

Seguridad

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API