Memorix (MCP server) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

크로스 에이전트: Claude Code, Cursor, Codex, Windsurf, Gemini CLI, OpenCode, Antigravity, Trae와 작동
리비전 이력이 있는 추가 전용
태그 기반 회상 (프로젝트, 언어, 결정)
로컬 SQLite 백엔드; 선택적 클라우드 동기화
소형 — 단일 Node 바이너리
MIT

라이브 데모

실제 사용 모습

memorix-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memorix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memorix-mcp",
      "command": "npx",
      "args": [
        "-y",
        "memorix"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "memorix-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "memorix"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add memorix-mcp -- npx -y memorix

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Memorix

모든 코딩 에이전트에 걸쳐 프로젝트 규약을 재작성 없이 공유

👤 여러 AI 코딩 도구를 사용하는 개발자 ⏱ ~15 min beginner

언제 쓸까: 첫날 Cursor, Claude Code, Codex에 동일한 모노레포 레이아웃을 설명하고 어느 것이 무엇을 알고 있는지 잊을 때.

사전 조건

실행 중인 Memorix — npx memorix — 기본값은 ~/.memorix.db

흐름

메모리 초기화

Save these facts about my project: package manager pnpm, runtime node 22, db postgres 16, auth in /apps/api/src/auth (not /legacy/auth).✓ 복사됨

→ 태그와 함께 5개 메모리 추가됨
다른 에이전트에서 회상

(in Cursor with same Memorix) — What conventions are set for this project?✓ 복사됨

→ 동일한 5개 메모리 반환
하나 업데이트

Update memory: now using node 24 (was 22). Keep history.✓ 복사됨

→ 업데이트됨; 이력이 리비전으로 보존

결과: 에이전트 전체와 며칠에 걸쳐 지속되는 프로젝트 컨텍스트.

함정

메모리가 오래됨 — decay를 사용하여 오래된 메모리에 낮은 신뢰도를 표시하세요; 에이전트가 그에 따라 가중치를 조정합니다

아키텍처 결정을 쿼리 가능한 메모리로 캡처

👤 기술 리드, 스태프 엔지니어 ⏱ ~20 min intermediate

언제 쓸까: 'Redux 대신 zustand 사용'이라는 결정을 내리고 그것이 유지되기를 원할 때.

흐름

결정 기록

Save decision: 'Use zustand, not Redux. Reason: simpler API, smaller bundle.' Tag: state-management.✓ 복사됨

→ 태그와 함께 결정 저장됨
적용 확인

Whenever Claude is about to import redux in this repo, reject and quote the decision.✓ 복사됨

→ 이후 import가 저장된 이유와 함께 표시됨

결과: 에이전트가 실제로 읽는 가벼운 ADR 로그.

함정

Memorix는 사용자별; 팀 전체 ADR은 클라우드 동기화 또는 커밋된 미러 필요 — --export ./adr.json을 사용하고 커밋하세요; 팀원은 --import로 동기화

함께 쓰기: github

디버깅 세션을 다른 에이전트에 넘기기

👤 작업 중에 모델을 전환하는 개발자 ⏱ ~10 min intermediate

언제 쓸까: Claude가 2시간 동안 디버깅을 했고 모든 것을 다시 설명하지 않고 Codex로 전환하고 싶을 때.

흐름

스냅샷

Snapshot current debugging context: hypothesis, what we ruled out, next step.✓ 복사됨

→ debug-session-<id> 태그와 함께 스냅샷 저장됨
다른 곳에서 이어받기

(in Codex) — Load debug session and continue from where Claude left off.✓ 복사됨

→ Codex가 스냅샷을 요약하고 다음 단계 제안

결과: 작업 중간에 에이전트 전환 시 불편함 없음.

함정

스냅샷이 너무 모호해서 새 에이전트가 처음부터 다시 시작 — Memorix의 스냅샷 도구가 가설, 증거, 다음 단계를 요청합니다 — 세 가지 모두 채우세요

조합

다른 MCP와 조합해 10배 효율

memorix-mcp + github

팀 공유를 위해 메모리를 커밋된 adr.json 파일에 미러링

memorix-mcp + filesystem

로컬 Memorix DB 백업

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
save	content: str, tags: str[]	사실 / 결정 / 스냅샷 저장	free
recall	query?, tags?, limit?	현재 작업에 관련 컨텍스트 가져오기	free
update	id, content	기존 메모리 수정 또는 정제	free
decay	older_than_days	주기적인 정리	free

비용 및 제한

운영 비용

API 쿼터: 로컬 SQLite — 디스크 용량에 따라 결정
호출당 토큰: 회상당 100~500
금액: 무료; 클라우드 동기화(사용 시) 비용 별도
팁: 주간 decay 실행으로 회상 쿼리가 6개월 된 디버그 노트가 아닌 최신 컨텍스트를 반환하게 하세요

보안

권한, 시크릿, 파급범위

자격 증명 저장: 기본적으로 로컬 SQLite; 클라우드 동기화는 API 키 필요

데이터 외부 송신: 기본적으로 로컬 전용

메모리에는 비밀이 포함될 수 있습니다 (예: '우리는 API 키 XYZ를 사용한다') — 내보내기/커밋 전에 검토하세요

문제 해결

자주 발생하는 오류와 해결

회상이 관련 없는 결과를 반환

태그가 일치하는지 확인하세요 — Memorix는 태그 필터와 퍼지 텍스트를 함께 사용합니다

확인: 필터 없이 실행하여 모든 메모리 확인

DB 잠금 오류

여러 에이전트가 동시에 쓰는 경우 — Memorix는 WAL을 사용합니다; 버전 >= 0.4인지 확인하세요

Import 실패

내보내기와 가져오기 버전 간의 스키마 불일치 — 먼저 둘 다 업그레이드하세요

대안

Memorix 다른 것과 비교

대안	언제 쓰나	단점/장점
doobidoo/mcp-memory-service	지식 그래프와 통합 같은 더 풍부한 기능을 원할 때	무겁지만 Memorix는 의도적으로 최소한으로 설계됨
OpenAI Memory / Anthropic Memory	하나의 제공자만 사용할 때	해당 제공자에 종속되지만 Memorix는 크로스 에이전트

Memorix