Quick Start

이 가이드는 먼저 하나의 기본 흐름을 성공시키는 데 집중합니다. LTM 서버를 설치하고, MCP 클라이언트에 등록하고, 폴더를 인덱싱한 뒤 에이전트가 검색하게 만듭니다. STM은 선택 사항이며 기본 기억 루프가 동작한 뒤 추가하면 됩니다.

1. 설치

uv tool install 'memtomem[all]'       # 또는: pipx install 'memtomem[all]'
mm --version

[all]은 Web UI, 로컬 ONNX 임베딩, 코드 청킹, 한국어 토크나이저, Ollama / OpenAI 프로바이더 클라이언트를 포함합니다. 더 작은 BM25 전용 설치는 설치를 참고하세요.

설치 직후 mm --version이 예상보다 오래된 버전을 출력하면 패키지 메타데이터를 새로고침하면서 업그레이드하세요:

uv tool install 'memtomem[all]' --refresh

2. 초기 설정

mm init

마법사는 프리셋 피커로 시작합니다:

프리셋	적합한 상황	동작
Minimal	첫 스모크 테스트, 최소 설치	BM25 키워드 검색만 사용
English	영어 프로젝트 대부분	로컬 ONNX 임베딩 + 영어 리랭커
Korean	한국어 또는 다국어 노트	다국어 임베딩, 리랭커, 한국어 토크나이저

스크립트나 CI에서는 다음을 사용할 수 있습니다:

mm init -y                   # minimal 프리셋, 프롬프트 없음
mm init --preset english -y  # 영어 프리셋, 프롬프트 없음
mm init --preset korean -y   # 한국어 프리셋, 프롬프트 없음
mm init --advanced           # 전체 마법사

설정 중 Claude Code 기억, Claude 플랜, Codex CLI 기억 같은 기존 AI 에이전트 메모리 폴더를 등록할 수 있습니다. 등록은 이후 변경 감시를 위한 것이므로, 이미 존재하는 파일은 mm index로 한 번 시드하세요.

3. 로컬 점검

에디터에 연결하기 전에 CLI가 설정과 DB를 열 수 있는지 확인합니다:

mm status

스토리지, 임베딩, 청크 수 요약이 보이면 정상입니다. 아직 인덱싱 전이라 청크가 0개인 것은 정상입니다.

4. MCP 클라이언트 연결

mm init 마법사에서 “Claude Code 에 자동 등록”을 선택했다면 LTM(memtomem-server)은 이미 등록되어 있습니다 — LTM 추가 명령은 필요 없습니다.

수동 등록이 필요한 경우(자동 등록을 건너뛰었거나 다른 머신으로 옮긴 경우):

claude mcp add memtomem -s user -- memtomem-server

Cursor MCP 설정에서 memtomem-server를 stdio MCP 서버로 등록합니다. 자세한 절차는 MCP 클라이언트 설정을 참고하세요.

Windsurf MCP 설정에서 memtomem-server를 stdio MCP 서버로 등록합니다. 자세한 절차는 MCP 클라이언트 설정을 참고하세요.

Claude Desktop MCP 설정에서 memtomem-server를 stdio MCP 서버로 등록합니다. 자세한 절차는 MCP 클라이언트 설정을 참고하세요.

등록 후 에이전트에게 “mem_status를 호출해줘”라고 요청하세요. MCP 클라이언트가 터미널에서 확인한 서버를 제대로 실행하는지 검증할 수 있습니다.

5. 기억 추가와 검색

먼저 CLI로 전체 루프를 확인합니다:

mm add \
  "스테이징 배포는 docs/deploy.md의 blue-green 체크리스트를 따른다" \
  --tags "deploy,ops"
mm search "스테이징 배포 체크리스트"

그 다음 에이전트가 검색해야 할 노트, 문서, 코드를 인덱싱합니다:

mm index ~/notes
mm index ~/projects/my-app/docs

이후 MCP 클라이언트에서는 자연어로 지시하면 됩니다:

에이전트에 지시	보통 호출되는 도구	결과
”memtomem 상태 확인”	`mem_status`	연결 및 인덱스 요약
”이 결정을 기억해줘…”	`mem_add`	마크다운 기억으로 저장
”이 docs 폴더 인덱싱해줘”	`mem_index`	기존 파일이 검색 가능해짐
”배포 체크리스트 검색”	`mem_search`	관련 기억 스니펫 순위 목록

6. Web UI 열기

mm web --open

기본 Web UI는 검색, 소스, 태그, 타임라인, 설정, Context Gateway를 다루는 사용자용 화면입니다. mm web --dev는 대부분의 사용자가 필요로 하지 않는 유지보수용 페이지를 추가합니다.

선택 사항: STM은 나중에 추가

memtomem-stm은 능동적 기억 서피싱과 응답 압축을 위한 별도 프록시입니다. 위 LTM 흐름이 동작한 뒤 추가하세요:

uv tool install memtomem-stm
mms init --mcp claude
mms health

도구 응답 압축이나 자동 기억 주입이 필요해질 때 STM 개요를 참고하세요.

다음 단계

세션을 넘나드는 기억 — 한 세션에서 저장하고 다른 세션에서 불러오기
설치 — 설치 방식과 extras
하이브리드 검색 — BM25 + 벡터 + RRF 융합
MCP 도구 — core, standard, full 도구 모드
Context Gateway — 에이전트, 스킬, 커맨드를 런타임 간 동기화