receptron/mulmoclaude

MulmoClaude – 로컬에서 실행되는 AI 네이티브 개인 보조 플랫폼

무엇인가요 – MulmoClaude는 자신의 컴퓨터에서 Claude 기반 AI 보조를 실행할 수 있는 오픈소스 애플리케이션입니다. 보조는 워크스페이스 (디스크 상의 일반 파일)에 존재하며, 개인용 위키, 데이터 컬렉션, 자동화, 그리고 Claude가 필요에 따라 생성할 수 있는 소규모 맞춤형 앱을 저장합니다. 모든 AI 기반 로직은 로컬(또는 Docker 사전)에서 실행되며, 절대 당신의 기기에서 벗어나지 않습니다.

왜 중요한가요 – 개인 보조의 가치는 단순한 언어 모델이 아니라, 당신에 대한 지식의 축적에 있습니다. MulmoClaude는 이러한 지식을 자체 호스팅, 파일 기반 저장소로 제공하며, 웹 채팅이나 수십 가지 메시징 브리지를 통해 당신이 Claude가 플러그인(위키, 회계, 피드, 이미지 생성 등)을 통합하여 작동할 수 있도록 합니다.

---

빠른 시작 (한 줄 명령어)

npx mulmoclaude@latest   # 서버를 시작하고 http://localhost:3001을 엽니다

터미널을 열어두거나, npx mulmoclaude@latest create-shortcut로 데스크톱 바로가기를 생성하세요.

핵심 구성 요소

구성 요소	역할
서버	Node.js 20+ 프로세스로 UI, REST API, socket.io 브리지 호스팅
Claude Code CLI	백엔드 LLM; 도구 호출, Bash 접근, 스킬 실행 제공
Docker 사전 (옵션)	Claude를 컨테이너 내에서 실행하며, 워크스페이스와 Claude 설정만 공개
플러그인 / 레지스트리	개인용 위키, 회계 시스템, SEC 제출서 리더, 데이터 피드 등 내장 기능
역할	사전 정의된 성격(일반, 사무, 가이드 & 플래너, 아티스트, 튜터, 스토리텔러)으로 도구 팔레트를 전환해 빠르고 집중된 응답 가능
브리지	별도의 npm 패키지(@mulmobridge/*)로 Telegram, Slack, Discord, WhatsApp, 이메일, SMS 등 socket.io를 통해 서버와 연결
스킬	재사용 가능한 Claude Code 스킬 폴더(~/.claude/skills/…)로 UI에서 단일 클릭으로 목록 및 실행 가능

할 수 있는 일 (예시 프롬프트)

• "프로젝트 제안서를 작성해줘" → 풍부한 마크다운 문서
• "지난 분기의 수익을 차트로 보여줘" → 인터랙티브 ECharts 차트
• "교토 여행 계획을 만들어줘" → 이미지가 포함된 도안 가이드
• "할 일 목록을 설정해줘" → 스키마 기반 컬렉션으로 백엔드된 칸반 보드
• "이 기사를 인게스트해줘: " → 영구적인 [[링크]]를 가진 위키 페이지
• "태양이 지는 장면의 이미지를 생성해줘" → Gemini 3.1 Flash 이미지 생성 (Gemini API 키 필요)
• "이 RSS 피드를 구독해줘" → /feeds 아래에 저장되어 주기적으로 갱신되는 데이터 피드

이 모든 기능은 전용 페이지(/wiki, /feeds, /collections, /automations, /files, ...)에서 접근 가능하며, 각각의 채팅 컴포저는 자동으로 관련 컨텍스트를 제공합니다.

설치 및 사전 요구 사항

요구 사항	확보 방법
Node.js 20+	nodejs.org에서 다운로드
Claude Code CLI	npm i -g @anthropic/claude-code (또는 README 링크 참조) 설치 후 claude를 한 번 실행하여 OAuth 완료
ffmpeg (옵션, 동영상 생성용)	brew install ffmpeg / apt install ffmpeg / winget install Gyan.FFmpeg
Docker Desktop (권장)	docker.com에서 설치 – 사전 모드 자동 활성화
Gemini API 키 (옵션, 이미지 생성용)	Google AI Studio에서 생성하고 .env에 GEMINI_API_KEY=… 추가
whisper.cpp (macOS 전용, 옵션)	로컬 음성 입력을 위해 설치

사전 요구 사항 설치 후 위의 한 줄 명령어를 실행하거나, 개발용으로 리포지토리 복제:

git clone https://github.com/receptron/mulmoclaude.git
cd mulmoclaude && yarn install
cp .env.example .env   # 이미지 생성을 원하면 GEMINI_API_KEY 추가
yarn dev               # UI는 http://localhost:5173에서 이용 가능

보안 모델

• Claude Code는 완전한 Bash 접근 권한을 가짐; Docker 없이 사용 시 사용자가 접근 가능한 모든 파일(SSH 키 포함)을 읽고 쓸 수 있음. 워크스페이스와 ~/.claude 설정만 허용하려면 Docker 사전 사용.
• Bearer 토큰 인증은 모든 /api/* 엔드포인트를 보호. 토큰은 서버 시작 시 생성되어 <meta> 태그를 통해 브라우저에 주입됨.
• 자격 증명 전달은 SANDBOX_SSH_AGENT_FORWARD 및 SANDBOX_MOUNT_CONFIGS로 선택적 활성화.
• 파일 로깅 – 인간이 읽을 수 있는 콘솔 로그 + server/system/logs/ 아래에서 매일 회전되는 JSON 로그.

생태계 및 확장성

• 브리지 패키지 (@mulmobridge/*)는 보조를 사용하는 모든 채팅 플랫폼에 노출할 수 있음. 자식 프로세스로 실행되며 서버 재시작 후 자동 재연결.
• 스킬 – ~/.claude/skills/ 아래에 SKILL.md를 포함한 폴더는 UI에서 탐색, 목록화, 단일 클릭 실행 가능. 프로젝트 스코프 스킬은 워크스페이스 내에 있으며, 동일한 이름의 사용자 스코프 스킬을 오버라이드.
• 플러그인 – 개발자 문서를 따르면 추가 네이티브 플러그인(예: 더 많은 회계 도구, 사용자 정의 데이터 파서)을 레지스트리에 확장 가능.

라이선스 및 커뮤니티

• 라이선스: MIT (LICENSE 참조).
• 업데이트 및 공지 – 프로젝트 소유자 Satoshi Nakajima와 "Singularity Society" 계정(일본어)이 X(구 Twitter)에 게시. 리포지토리에는 CI 배지, 스타 수, "AI 네이티브 애플리케이션" 철학을 설명하는 MANIFEST.md 포함.

---

요약하면: MulmoClaude는 모든 기억을 일반 파일로 저장하고, 웹 UI 또는 선호하는 메신저를 통해 대화할 수 있는 자체 호스팅형 확장 가능한 AI 보조입니다. 선택적 Docker 사전을 통해 데이터를 완전히 제어할 수 있습니다. 단일 목적의 챗봇이 아니라, 개인용, 프라이버시 우선의 AI 동반자이자, 필요 시 즉시 소규모 맞춤형 앱을 생성할 수 있는 완전한 스택 플랫폼입니다.