genlayer-cli-mcp
GenLayer CLI MCP
MCP-сервер для ИИ-агентов, которым необходимо работать с проектами GenLayer.
Он предоставляет:
genlayer: полный доступ к GenLayer CLIgenvm_lint: доступ кgenvm-lintgenlayer_deploy: развертывание контрактов с помощьюgenlayer-jscheck_tools: проверка доступности локальных инструментов и конфигурации закрытого ключа
Сервер использует транспорт stdio и выполняет команды с помощью spawn(command, args).
Требования
Node.js 18+
GenLayer CLI доступен в
PATHGenVM linter доступен в
PATH
Установите внешние инструменты:
npm install -g genlayer
py -3.12 -m pip install genvm-linterПроверьте их:
genlayer --version
genvm-lint --versionКонфигурация MCP
Если этот пакет опубликован в npm:
{
"mcpServers": {
"genlayer-cli": {
"command": "npx",
"args": ["-y", "genlayer-cli-mcp"],
"env": {
"GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}
}
}
}Если запуск производится из этого репозитория:
{
"mcpServers": {
"genlayer-cli": {
"command": "node",
"args": ["E:\\genlayer-cli-mcp\\dist\\index.js"],
"env": {
"GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}
}
}
}Допустимые имена переменных окружения для закрытого ключа:
GENLAYER_PRIVATE_KEYGENLAYER_PRV_KEYGENLAYER_PRIVKEYPRIVATE_KEY
Закрытый ключ может быть либо 0x плюс 64 шестнадцатеричных символа, либо просто 64 шестнадцатеричных символа. Если настроенный ключ отсутствует или недействителен, genlayer_deploy генерирует новый закрытый ключ и выполняет развертывание с ним в рамках того же вызова инструмента. Когда генерируется новый ключ, ответ включает его, чтобы вы могли его сохранить.
Локальная разработка
cd E:\genlayer-cli-mcp
npm install
npm run build
npm run smokeЗапустите сервер:
node E:\genlayer-cli-mcp\dist\index.jsУпакуйте локально:
npm packОпубликуйте в npm:
npm login
npm publish --access publicИнструменты
check_tools
Проверяет node, genlayer, python, genvm-lint и конфигурацию закрытого ключа.
Пример промпта для ИИ:
Use MCP tool check_tools from genlayer-cli.genlayer
Запускает genlayer <args...> с полным доступом к командам.
Пример:
{
"args": ["--version"]
}Пример развертывания через raw CLI:
{
"args": [
"deploy",
"--contract",
"E:\\path\\to\\contract.py",
"--rpc",
"http://localhost:4000/api"
],
"timeoutMs": 120000
}genvm_lint
Запускает genvm-lint <args...>.
Пример:
{
"args": ["check", "E:\\path\\to\\contract.py"],
"timeoutMs": 120000
}genlayer_deploy
Развертывает интеллектуальный контракт (Intelligent Contract) через genlayer-js.
Это рекомендуемый инструмент развертывания для ИИ-агентов, так как он обрабатывает резервный вариант с закрытым ключом:
Использует
privateKeyиз входных данных инструмента, если он действителен.В противном случае использует закрытый ключ из переменной окружения конфигурации MCP, если он действителен.
В противном случае генерирует новый закрытый ключ.
Немедленно выполняет развертывание с выбранным/сгенерированным закрытым ключом.
Пример:
{
"contractPath": "E:\\path\\to\\contract.py",
"chain": "localnet",
"rpcUrl": "http://localhost:4000/api",
"autoFundLocalnet": true,
"waitForReceipt": true,
"receiptStatus": "ACCEPTED",
"timeoutMs": 120000
}Необязательные поля:
{
"privateKey": "0x...",
"args": [],
"kwargs": {},
"cwd": "E:\\project",
"leaderOnly": false,
"consensusMaxRotations": 5,
"initializeConsensus": true,
"fundAmount": 10,
"receiptRetries": 50,
"receiptIntervalMs": 5000,
"exposePrivateKey": false
}Поддерживаемые сети:
localnetstudionettestnetAsimovtestnetBradbury
Примеры настройки агента
Используйте одно и то же определение MCP-сервера для агентов кодирования, которые поддерживают MCP через stdio. Замените закрытый ключ на свой собственный ключ testnet/local или оставьте его недействительным, если хотите, чтобы genlayer_deploy сгенерировал новый ключ во время развертывания.
Codex
Добавьте этот MCP-сервер в конфигурацию MCP вашего Codex:
{
"mcpServers": {
"genlayer-cli": {
"command": "npx",
"args": ["-y", "genlayer-cli-mcp"],
"env": {
"GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}
}
}
}Предлагаемый промпт для 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
Добавьте MCP-сервер в настройки MCP Antigravity:
{
"mcpServers": {
"genlayer-cli": {
"command": "npx",
"args": ["-y", "genlayer-cli-mcp"],
"env": {
"GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}
}
}
}Предлагаемый промпт для 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
Добавьте сервер с помощью команды добавления MCP в Claude Code:
claude mcp add genlayer-cli -- npx -y genlayer-cli-mcpЕсли ваша настройка Claude Code поддерживает переменные окружения в конфигурации MCP, добавьте:
{
"GENLAYER_PRIVATE_KEY": "0x_your_private_key_here"
}Альтернативная команда для локального источника:
claude mcp add genlayer-cli -- node E:\genlayer-cli-mcp\dist\index.jsПредлагаемый промпт для 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"
}Безопасность
Этот MCP-сервер намеренно предоставляет полный доступ к командам GenLayer. ИИ-агенты могут выполнять команды, изменяющие состояние, такие как deploy, write, up, stop и init.
Не указывайте закрытый ключ основной сети (mainnet) в конфигурации MCP, если вы не доверяете ИИ-клиенту и всем включенным инструментам.
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ngh1105/genlayer-cli-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server