GenLayer CLI MCP

MCP-Server für KI-Agenten, die mit GenLayer-Projekten arbeiten müssen.

Er stellt folgende Funktionen bereit:

• genlayer: vollständiger Zugriff auf die GenLayer-CLI

• genvm_lint: Zugriff auf genvm-lint

• genlayer_deploy: stellt Verträge mit genlayer-js bereit

• check_tools: überprüft die Verfügbarkeit lokaler Tools und die Konfiguration privater Schlüssel

Der Server verwendet den stdio-Transport und führt Befehle mit spawn(command, args) aus.

Anforderungen

• Node.js 18+

• GenLayer-CLI verfügbar im PATH

• GenVM-Linter verfügbar im PATH

Installieren Sie die externen Tools:

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

Überprüfen Sie diese:

genlayer --version
genvm-lint --version

MCP-Konfiguration

Falls dieses Paket auf npm veröffentlicht wurde:

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

Bei Ausführung aus diesem Repository:

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

Akzeptierte Umgebungsvariablennamen für private Schlüssel:

• GENLAYER_PRIVATE_KEY

• GENLAYER_PRV_KEY

• GENLAYER_PRIVKEY

• PRIVATE_KEY

Der private Schlüssel kann entweder 0x gefolgt von 64 Hex-Zeichen oder nur 64 Hex-Zeichen lang sein. Wenn der konfigurierte Schlüssel fehlt oder ungültig ist, generiert genlayer_deploy einen neuen privaten Schlüssel und stellt den Vertrag im selben Tool-Aufruf damit bereit. Wenn ein neuer Schlüssel generiert wird, ist dieser in der Antwort enthalten, damit Sie ihn speichern können.

Lokale Entwicklung

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

Starten Sie den Server:

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

Paket lokal erstellen:

npm pack

Auf npm veröffentlichen:

npm login
npm publish --access public

Tools

check_tools

Überprüft node, genlayer, python, genvm-lint und die Konfiguration des privaten Schlüssels.

Beispiel für einen KI-Prompt:

Use MCP tool check_tools from genlayer-cli.

genlayer

Führt genlayer <args...> mit vollem Befehlszugriff aus.

Beispiel:

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

Beispiel für eine Bereitstellung über die rohe CLI:

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

genvm_lint

Führt genvm-lint <args...> aus.

Beispiel:

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

genlayer_deploy

Stellt einen Intelligent Contract über genlayer-js bereit.

Dies ist das empfohlene Bereitstellungstool für KI-Agenten, da es ein Fallback für private Schlüssel bietet:

1. Verwenden Sie privateKey aus der Tool-Eingabe, falls gültig.

2. Andernfalls verwenden Sie den privaten Schlüssel aus der MCP-Konfigurationsumgebung, falls gültig.

3. Andernfalls generieren Sie einen neuen privaten Schlüssel.

4. Stellen Sie den Vertrag sofort mit dem ausgewählten/generierten privaten Schlüssel bereit.

Beispiel:

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

Optionale Felder:

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

Unterstützte Chains:

• localnet

• studionet

• testnetAsimov

• testnetBradbury

Beispiele für die Agenten-Einrichtung

Verwenden Sie dieselbe MCP-Serverdefinition für Coding-Agenten, die MCP über stdio unterstützen. Ersetzen Sie den privaten Schlüssel durch Ihren eigenen Testnet-/lokalen Schlüssel oder lassen Sie ihn ungültig, wenn genlayer_deploy während der Bereitstellung einen neuen Schlüssel generieren soll.

Codex

Fügen Sie diesen MCP-Server zu Ihrer Codex-MCP-Konfiguration hinzu:

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

Empfohlener Codex-Prompt:

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

Fügen Sie den MCP-Server in den MCP-Einstellungen von Antigravity hinzu:

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

Empfohlener Antigravity-Prompt:

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

Fügen Sie den Server mit dem MCP-Add-Befehl von Claude Code hinzu:

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

Wenn Ihr Claude Code-Setup Umgebungsvariablen in der MCP-Konfiguration unterstützt, fügen Sie Folgendes hinzu:

{
  "GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}

Alternativer Befehl für lokale Quellen:

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

Empfohlener Claude Code-Prompt:

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"
}

Sicherheit

Dieser MCP-Server ermöglicht absichtlich den vollständigen Zugriff auf GenLayer-Befehle. KI-Agenten können zustandsverändernde Befehle wie deploy, write, up, stop und init ausführen.

Hinterlegen Sie keinen privaten Mainnet-Schlüssel in der MCP-Konfiguration, es sei denn, Sie vertrauen dem KI-Client und allen aktivierten Tools.