GenLayer CLI MCP

GenLayer 프로젝트와 작업해야 하는 AI 에이전트를 위한 MCP 서버입니다.

다음 기능을 제공합니다:

genlayer: GenLayer CLI에 대한 전체 액세스 권한
genvm_lint: genvm-lint에 대한 액세스 권한
genlayer_deploy: genlayer-js를 사용하여 컨트랙트 배포
check_tools: 로컬 도구 가용성 및 개인 키 설정 확인

이 서버는 stdio 전송을 사용하며 spawn(command, args)를 통해 명령을 실행합니다.

요구 사항

Node.js 18+
PATH에서 사용 가능한 GenLayer CLI
PATH에서 사용 가능한 GenVM linter

외부 도구 설치:

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_KEY
GENLAYER_PRV_KEY
GENLAYER_PRIVKEY
PRIVATE_KEY

개인 키는 0x와 64자 16진수 문자열이거나 64자 16진수 원본 문자열일 수 있습니다. 설정된 키가 없거나 유효하지 않은 경우, 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 및 개인 키 설정을 확인합니다.

AI 프롬프트 예시:

Use MCP tool check_tools from genlayer-cli.

`genlayer`

전체 명령 액세스 권한으로 genlayer <args...>를 실행합니다.

예시:

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

원시 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`

genlayer-js를 통해 Intelligent Contract를 배포합니다.

개인 키 폴백(fallback)을 처리하므로 AI 에이전트에 권장되는 배포 도구입니다:

유효한 경우 도구 입력에서 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
}

지원되는 체인:

localnet
studionet
testnetAsimov
testnetBradbury

에이전트 설정 예시

stdio를 통한 MCP를 지원하는 코딩 에이전트에 동일한 MCP 서버 정의를 사용하십시오. 개인 키를 자신의 테스트넷/로컬 키로 바꾸거나, genlayer_deploy가 배포 중에 새 키를 생성하도록 하려면 유효하지 않은 상태로 두십시오.

Codex

Codex MCP 설정에 이 MCP 서버를 추가하십시오:

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

Antigravity의 MCP 설정에 MCP 서버를 추가하십시오:

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

Claude Code의 MCP 추가 명령으로 서버를 추가하십시오:

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 명령 액세스 권한을 노출합니다. AI 에이전트는 deploy, write, up, stop, init와 같은 상태 변경 명령을 실행할 수 있습니다.

AI 클라이언트와 활성화된 모든 도구를 신뢰하지 않는 한 MCP 설정에 메인넷 개인 키를 넣지 마십시오.

genlayer-cli-mcp