Maroo Maroo docs

마루 MCP — @maroo-chain/mcp

component agents

Model Context Protocol을 통해 AI 클라이언트에 마루 지식 베이스, 체인 조회, 로컬 키 기반 테스트넷 지갑을 제공합니다. 마루와 통신해야 하는 AI 에이전트를 위한 가장 가벼운 통합 경로입니다.

@maroo-chain/mcp는 공식 마루 MCP 서버입니다. npx로 바로 설치할 수 있는 Model Context Protocol 키트로, Claude Code, Cursor, Claude Desktop, Windsurf, Gemini CLI와 같은 호환 AI 클라이언트에 마루 지식 베이스, 체인·PCL 조회, 로컬 키 기반 테스트넷 지갑을 제공합니다. 읽기 전용이 아니며, 지갑 도구는 개인 키를 생성하거나 가져와 그 키로 테스트넷 OKRW 전송에 서명하고 브로드캐스트합니다. 에이전트에 온체인 정책을 따르는 WaaS 관리형 AA 지갑이 필요하다면 @maroo-chain/m-aws와 함께 사용하고, 마루를 이해하는 것이 주된 목적이라면 단독으로 실행합니다.

설치 (AI 클라이언트별 한 줄)

# Claude Code
claude mcp add maroo -- npx -y @maroo-chain/mcp serve

# 또는 전역 설치 후 직접 실행:
npm install -g @maroo-chain/mcp
maroo-mcp init       # ~/.maroo/keystore 생성, MCP 클라이언트에 `maroo` 등록(클라이언트마다 확인)
maroo-mcp serve      # MCP 서버 (stdio) 시작

노출하는 기능 — 3개 카테고리, 12개 도구

도구 중 세 개는 읽기 전용이 아닙니다. maroo_wallet_create와 maroo_wallet_import는 AES-256-GCM으로 암호화한 키를 ~/.maroo/keystore/에 저장하고, maroo_send는 그 키로 테스트넷 OKRW 전송에 서명해 브로드캐스트한 뒤 로컬 지출 한도를 위해 금액을 ~/.maroo/daily-spending.json에 기록합니다. 이 세 도구는 개인 키(maroo_wallet_import)와 passphrase를 도구 인자로 받으므로, 모델 제공자가 이 값을 보고 MCP 클라이언트가 대화 기록에 남깁니다. 따라서 버려도 되는 테스트넷 키만 사용합니다. 나머지 9개 도구는 읽기만 합니다.

지식 (3개) — AI가 행동에 앞서 마루를 실제로 이해하도록 돕는 도구입니다.

  • maroo_discover — 모든 KB 섹션의 적응형 개요를 제공합니다. 마루 관련 대화에서 가장 먼저 호출합니다.
  • maroo_kb_search — 모든 KB 엔트리에 대한 키워드 검색을 수행합니다.
  • maroo_kb_lookup — id 또는 경로로 특정 엔트리를 읽어옵니다.


지갑 & 체인 (4개) — viem 기반으로 마루 테스트넷(chainId 450815)에 대한 일반 체인 접근을 제공합니다.

  • maroo_chain_info — 체인 상태(블록 높이, 가스 가격, RPC, 탐색기)를 반환합니다.
  • maroo_wallet_create — 새 키를 생성하고 암호화해 ~/.maroo/keystore/에 저장합니다.
  • maroo_wallet_import — 기존 키를 가져와 암호화하여 저장합니다.
  • maroo_balance — OKRW 잔액과 온체인 PCL 일일 볼륨 스냅샷을 반환합니다.


컴플라이언스 & 트랜잭션 (5개) — 마루의 컴플라이언스 게이트(PCL 프리컴파일)와 전송을 다룹니다.

  • maroo_pcl_check — 읽기 전용 미리보기로, PCL 전역 정책이 이 전송을 허용하는지(전송당 상한, 일일 볼륨, KYC 면제) 확인합니다.
  • maroo_pcl_limits — 주소에 적용되는 일일 윈도, 전송당 상한, KYC 상태를 반환합니다.
  • maroo_preflight — maroo_send 전에 로컬 정책, PCL, 잔액을 한 번에 확인합니다.
  • maroo_send — preflight를 먼저 실행한 뒤 테스트넷 OKRW 전송에 서명해 브로드캐스트합니다.
  • maroo_tx_status — 해시로 트랜잭션 영수증을 조회합니다.

어느 것을 사용할지

MCP 서버는 두 개이지만 결정해야 할 사항은 하나입니다.

  • @maroo-chain/mcp (이 패키지)는 체인의 눈 역할에 로컬 키 기반 테스트넷 지갑을 더한 패키지입니다. KB 지식, 체인·PCL 조회, 에이전트가 생성하거나 가져온 키로 서명하는 테스트넷 OKRW 전송을 제공하며 단독으로 사용할 수 있고, 마루에 대해 추론하고 싶은 모든 AI 에이전트의 좋은 기본값입니다.
  • @maroo-chain/m-aws는 상태 보존 에이전트 지갑 스택으로, AA 지갑, 온체인 정책, 전송 기능을 제공합니다. WaaS가 에이전트 대신 서명하므로 이 스택의 도구는 개인 키나 passphrase를 받지 않습니다. 에이전트가 관리형 에이전트 지갑에서 정책에 따라 OKRW를 움직여야 할 때 이 MCP와 함께 사용하며, 지갑 스택의 자세한 내용은 concepts/agents/maws-architecture-overview 페이지를 참고합니다.


두 패키지는 별도의 npm 패키지로 출시되며, AI 클라이언트에 둘 중 하나(또는 둘 다)를 연결할 수 있습니다.

링크

mcpagentmaroo-chainai-clientclaude-code
ESC
검색어를 입력하세요
↑↓ navigate ↵ select esc close