Memory MCP

AI 코딩 어시스턴트를 위한 영구 메모리 및 세션 전문 검색 기능으로, MCP 서버로 노출됩니다.

문제점

AI 코딩 어시스턴트는 세션 간의 모든 내용을 잊어버립니다. 아키텍처 결정, 사용자 환경 설정, 프로젝트 컨텍스트, 지난 화요일에 디버깅한 내용 등 모든 것이 사라집니다. 그래서 매번 같은 내용을 다시 설명해야 합니다.

Memory MCP는 다음 두 가지 기능으로 이 문제를 해결합니다.

1. 명시적 메모리 -- 세션 간에 유지되는 메모, 결정 사항, 패턴 및 환경 설정을 저장합니다. 어시스턴트가 당신이 말한 내용을 기억합니다.

2. 세션 검색 -- 전체 대화 기록에 대한 전문 검색을 수행합니다. 로그를 일일이 뒤질 필요 없이 3주 전에 논의했던 내용을 바로 찾을 수 있습니다.

데이터베이스 서버도, 백그라운드 프로세스도, 클라우드도 필요 없습니다. 사용자의 컴퓨터에 있는 단 하나의 SQLite 파일만 있으면 됩니다.

Related MCP server: MCP Vector Memory

지원되는 세션 소스

새로운 소스를 추가하려면 파서 파일 하나와 레지스트리 항목이 필요합니다. 새 세션 소스 추가하기를 참조하세요.

설치

SQLite FTS5 지원이 포함된 Python 3.11+가 필요합니다 (표준 Python 빌드에 포함됨).

pip install -e .

또는 uv를 사용하여 직접 실행하세요 (설치 불필요):

uv run --directory /path/to/memory_mcp python -m memory_mcp

MCP 설정

MCP 클라이언트 설정(예: ~/.claude/mcp.json 또는 프로젝트 수준의 .mcp.json)에 추가하세요:

pip 설치 시:

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp"
    }
  }
}

uv 사용 시 (설치 불필요):

{
  "mcpServers": {
    "memory": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/memory_mcp", "python", "-m", "memory_mcp"]
    }
  }
}

도구

메모리 (명시적 지식 저장소)

세션 (과거 대화 검색)

작동 원리

시작 시 Memory MCP는 구성된 세션 디렉토리를 스캔하고 모든 대화를 FTS5 전문 검색 인덱스가 포함된 로컬 SQLite 데이터베이스에 인덱싱합니다. 이후 실행 시에는 mtime이 변경되지 않은 파일은 건너뜁니다.

• 데이터베이스 위치: ~/.memory_mcp/memory.db (MEMORY_MCP_DB 환경 변수로 재정의 가능)

• 세션 소스: 표준 위치에서 자동 감지 (MEMORY_MCP_SOURCES 환경 변수로 확장 가능, 형식: type:path;type:path)

• 인덱싱: 파일 mtime 기준 증분 방식, 8개 스레드로 병렬 처리

• 검색: BM25 랭킹, 접두사 매칭, 구문 지원을 포함한 FTS5

새 세션 소스 추가하기

1. SessionParser 프로토콜을 구현하는 memory_mcp/parsers/your_source.py를 생성합니다:

   • source_type: str 속성

   • parse_file(path: str) -> ParsedSession | None 메서드

2. memory_mcp/parsers/__init__.py에 등록합니다.

3. memory_mcp/config.py에 디렉토리 감지 기능을 추가합니다.

예제는 parsers/claude_code.py 또는 parsers/omp.py를 참조하세요.

테스트

python tests/test_e2e.py

엔드투엔드 테스트는 MCP 서버를 하위 프로세스로 시작하여 stdio 프로토콜을 통해 8개의 모든 도구를 실행하고 응답을 검증합니다. 실제 데이터가 영향을 받지 않도록 임시 데이터베이스를 사용합니다.

아키텍처

memory_mcp/
  server.py        # FastMCP entry point, lifespan manages DB + startup scan
  config.py        # Auto-detects session dirs, DB path
  db.py            # SQLite + FTS5 schema, all queries, sync triggers
  scanner.py       # Walks session dirs, dispatches to parsers, parallel indexing
  parsers/
    base.py        # ParsedSession / ParsedMessage dataclasses, SessionParser protocol
    claude_code.py # Claude Code JSONL parser (merges streamed assistant blocks)
    claude_history.py # Claude Code history.jsonl parser (one file, many sessions)
    omp.py         # OMP JSONL parser
    opencode.py    # OpenCode SQLite parser (reads DB directly, read-only)
  tools/
    memory.py      # save_memory, search_memory, list_memories, delete_memory
    sessions.py    # list_sessions, get_session, search_sessions, refresh_sessions

라이선스

MIT