마루 MCP — @maroo-chain/mcp
Model Context Protocol을 통해 AI 클라이언트에 읽기 전용 마루 지식 베이스와 체인 접근을 제공합니다. 마루와 통신해야 하는 AI 에이전트를 위한 가장 가벼운 통합 경로입니다.
@maroo-chain/mcp는 공식 Maroo MCP 서버입니다. npx로 바로 설치할 수 있는 Model Context Protocol 키트로, Claude Code, Cursor, Claude Desktop, Windsurf, Gemini CLI와 같은 호환 AI 클라이언트에 마루 지식 베이스와 체인 상태에 대한 읽기 전용 접근을 제공합니다. 에이전트가 지갑이나 전송 기능까지 필요하다면 @maroo-chain/m-aws와 함께 사용하고, 마루를 이해하는 것만 필요하다면 단독으로 실행합니다.
설치 (AI 클라이언트별 한 줄)
# Claude Code
claude mcp add maroo -- npx -y @maroo-chain/mcp serve
# 또는 전역 설치 후 직접 실행:
npm i -g @maroo-chain/mcp
maroo-mcp init # ~/.maroo/ 초기 스캐폴딩 생성
maroo-mcp serve # MCP 서버 (stdio) 시작노출하는 기능 — 3개 카테고리, 12개 도구
모든 도구는 읽기 전용입니다. 영속 상태는 AES-256-GCM 암호화된 로컬 키를 위한 선택적
지식 (3개) — AI가 행동에 앞서 마루를 실제로 이해하도록 돕는 도구입니다.
지갑 & 체인 (4개) — viem 기반으로 마루 테스트넷(chainId 450815)에 대한 일반 체인 접근을 제공합니다.
컴플라이언스 & 트랜잭션 (5개) — 마루의 컴플라이언스 게이트(PCL 프리컴파일)와 전송 ergonomics를 다룹니다.
~/.maroo/keystore/ 하나뿐입니다.지식 (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_wallet_import— 기존 키를 가져와 암호화하여 저장합니다.maroo_balance— OKRW 잔액과 온체인 PCL 볼륨 스냅샷을 반환합니다.
컴플라이언스 & 트랜잭션 (5개) — 마루의 컴플라이언스 게이트(PCL 프리컴파일)와 전송 ergonomics를 다룹니다.
maroo_pcl_check— 읽기 전용 미리보기로, 이 전송이 PCL 주기 볼륨 상한을 통과하는지 확인합니다.- (트랜잭션 준비·디코딩용 도구 4개가 추가로 포함됩니다.)
어느 것을 사용할지
MCP 서버는 두 개이지만 결정해야 할 사항은 하나입니다.
두 패키지는 별도의 npm 패키지로 출시되며, AI 클라이언트에 둘 중 하나(또는 둘 다)를 연결할 수 있습니다.
@maroo-chain/mcp(이 패키지)는 체인의 눈 역할을 합니다. KB 지식과 읽기 전용 체인 접근을 제공하며 단독으로 사용할 수 있고, 마루에 대해 추론하고 싶은 모든 AI 에이전트의 좋은 기본값입니다.@maroo-chain/m-aws는 상태 보존 에이전트 지갑 스택으로, AA 지갑, 온체인 정책, 전송 기능을 제공합니다. 에이전트가 실제로 OKRW를 움직여야 할 때 이 MCP와 함께 사용하며, 지갑 스택의 자세한 내용은concepts/agents/maws-architecture-overview페이지를 참고합니다.
두 패키지는 별도의 npm 패키지로 출시되며, AI 클라이언트에 둘 중 하나(또는 둘 다)를 연결할 수 있습니다.