MCP

layerx-mcp: Paxeer X LayerX agent 연동 MCP server 입문

Paxeer X의 LayerX agent MCP server를 로컬에서 소스 코드로 연동하려면 Go/C17/Rust 툴체인을 먼저 갖추고 공식 CLI로 설치해야 하며, 그렇지 않으면 빌드 단계에서 막힙니다.

Official source · GitHub - Sidiora-Labs/paxeer-monorepo

Install

layerx install mcp

누구에게 적합한가

  • Paxeer X Network 생태계에서 agent 기능을 연동하려는 개발자에게 적합합니다: 이 저장소는 해당 네트워크의 monorepo로, Paxeer X 체인(paxd, Go, EVM chain ID 125)과 LayerX 커널(layerxd, C17, 자율 agent를 위한 결정론적 실행 및 회계 도메인)을 포함하며, services/agent/crates/layerx-mcp에 위치한 MCP server와 Rust, Python, TypeScript SDK도 함께 제공합니다.
  • 소스 코드에서 빌드할 개발 환경을 이미 준비한 사용자에게 적합합니다: 공식적으로 명시된 툴체인 요구 사항은 Go 1.25.8(go.mod), 커널에 필요한 C17 컴파일러, Rust 1.91.1(rust-toolchain.toml), Solidity 0.8.27과 Foundry, 그리고 Node.js(npm workspaces)입니다.
  • 독립된 MCP 패키지만 설치하고 로컬 빌드는 하지 않으려는 사용자에게는 적합하지 않습니다: 사전 컴파일된 바이너리나 호스팅 서비스에 대한 안내는 근거 자료에 제공되지 않았습니다. 온체인 배포, 자산 보관 등의 작업에 대해서는 공식 문서가 로컬에서 감사(audit)를 통과하는 것만으로는 이러한 행위를 승인하지 않는다고 명확히 밝히고 있으며, 그 외의 구체적인 권한 경계에 대해서는 근거가 제시되지 않았습니다.

3분 만에 첫 시도 완료하기

  • 전제 조건: 공식 요구 사항에 따라 툴체인(Go 1.25.8, C17 컴파일러, Rust 1.91.1, Node.js 등)을 준비하고 해당 저장소를 로컬에 클론합니다. 이하는 공식 README가 제시하는 가장 직접적인 경로입니다.
  • 설치 및 구성: 저장소는 tools/platform/cli 아래에 개발자 CLI를 제공하며, layerx install mcp 명령으로 MCP 전송(transport)을 설치할 수 있습니다(별도로 layerx install a2a로 A2A 전송을 설치하는 방법도 있으며, 이는 부차적인 방식입니다). 이 단계가 공식이 권장하는 기본 구성 경로입니다.
  • 첫 저위험 검증: 저장소 루트에서 make layerxd와 make layerxctl을 실행하여 각각 LayerX 커널 데몬과 그 조작용 CLI를 빌드합니다(make paxeer-build는 build/paxd를 빌드합니다). 빌드 출력이 첫 번째 성공 신호입니다.
  • 성공 신호: 커널과 CLI의 빌드 산출물이 생성되고, layerx install mcp 완료 후 MCP 클라이언트에 LayerX의 MCP server가 나타나는 것입니다. 주의: 근거 자료에는 구체적인 CLI 하위 명령 목록이나 도구 호출 예시가 제공되지 않아, "전송 설치 + 빌드 성공" 단계까지만 확인할 수 있습니다. 더 깊은 호출 세부 사항은 저장소 내 문서를 기준으로 하고, 파라미터를 임의로 추측하지 마십시오.
  • 참고: 위 작업은 모두 로컬 상태에 대한 쓰기(컴파일 산출물, 로컬 구성)이며 원격 쓰기 작업이 아닙니다. 하지만 "무위험"이라고 볼 수는 없습니다. 로컬 읽기/쓰기, 네트워크 접근 등 프라이버시 경계에 대해서는 근거가 제시되지 않았습니다.

사용 사례

  • 사례 1: LayerX agent의 MCP 전송을 여러분의 MCP 클라이언트에 설치합니다. tools/platform/cli의 CLI에서 layerx install mcp를 실행한 뒤, 구성한 MCP 클라이언트에서 해당 server와 그 도구 목록이 나타나는지 확인합니다. 근거는 "전송이 설치되었고 server가 나타났다"는 것까지만 확인을 지원합니다. 구체적인 도구 이름과 파라미터는 공식적으로 채택된 근거 자료에 나열되어 있지 않으므로, 저장소 문서의 실제 출력을 기준으로 하십시오.
  • 사례 2: 로컬 개발을 위해 커널과 조작용 툴체인을 빌드합니다. 저장소를 클론한 후 루트에서 make layerxd와 make layerxctl을 실행하여 LayerX 커널 데몬과 조작용 CLI를 얻습니다. 체인 노드도 함께 빌드하려면 make paxeer-build를 실행하여 build/paxd를 얻습니다. 기대할 수 있는 결과는 빌드 명령이 성공적으로 해당 바이너리를 산출하는 것입니다. 실제 배포나 자산과 관련된 작업은 이 범위에 포함되지 않습니다.

사용 경계

  • 빌드와 로컬 구성은 로컬 상태에 대한 쓰기입니다. make public-audit(즉, scripts/ci/public-repo-audit.sh)는 변경 시마다 반드시 통과해야 하는 검사이지만, 공식 문서는 명확히 밝히고 있습니다: 로컬에서 감사를 통과하는 것이 컨트랙트 배포, 보관 이전, 실제 자산 처리를 승인하는 것은 아닙니다. 그러한 원격 쓰기 작업에는 추가적인 공식 확인 절차가 필요하며, 그 절차의 세부 사항은 근거 자료에 제시되지 않았습니다.
  • 자격 증명, 지갑, API key 등의 구성 요구 사항은 채택된 근거 자료에 설명되어 있지 않으므로, 첫 시도 시 민감한 정보를 미리 제공하지 마십시오. 실제로 필요한 경우 공식 문서를 기준으로 하십시오.
  • 아직 확인되지 않은 핵심 정보: MCP server가 노출하는 구체적인 도구 목록과 파라미터, 실행 포트, 클라이언트 호환 범위, 읽기 전용 도구의 프라이버시 및 네트워크 접근 경계는 모두 근거 자료에 나타나지 않았으므로, 사용 전에 반드시 저장소 문서에서 직접 확인하십시오.
  • readOnlyHint 유형의 읽기 전용 도구는 설령 존재하더라도 쓰기 작업을 수행하지 않는다는 것만을 의미할 뿐, 네트워크에 접속하지 않거나 로컬 데이터를 읽지 않는다는 뜻이 아닙니다. 이를 근거로 전체적인 보안 결론을 내려서는 안 됩니다.