mcp-memory: SQLite FTS5 + Google의 OKF를 이용한 빠른 에이전트 메모리

무거운 벡터 데이터베이스를 추가하지 않고 AI 코딩 에이전트에 영구 메모리를 부여할 방법을 찾고 계신가요? mcp-memory는 에이전트 메모리를 Google의 OKF v0.2 Markdown 파일로 저장하고, SQLite FTS5로 모든 것을 로컬에 인덱싱하며, 네 가지 깔끔한 MCP 도구를 제공하는 오픈소스 MCP 서버입니다. Claude Desktop, Cursor, Antigravity, Windsurf 또는 Codex에 설정 마법사로 간편하게 통합할 수 있습니다.

주요 기능

mcp-memory는 이중 계층 아키텍처를 유지합니다:

• 사람이 탐색 가능한 OKF 디렉토리: 모든 메모리는 memory/ 디렉토리에 원시 .md 파일로 저장되며, 루트 index.md(okf_version: "0.2" 포함) 및 업데이트 기록을 위한 log.md가 포함됩니다.
• SQLite FTS5 인덱스: 전체 텍스트 검색과 트리거로 주요 조회를 20ms 미만으로, 키워드 검색을 즉시 처리합니다.

메모리는 YAML frontmatter(type, key, namespace, tags, generated, sources, verified, status, stale_after)를 포함하는 OKF v0.2 Markdown 문서로 저장됩니다.

MCP 도구

서버는 네 가지 기본 도구를 제공합니다:

• memory_store – 레코드를 저장하거나 업데이트합니다. key, content, project_root가 필요합니다. 선택 사항: tags, namespace(기본값 default), concept_type, title, description, resource, status, stale_after, sources, verified, generated_by.
• memory_retrieve – key와 namespace로 특정 메모리를 가져옵니다.
• memory_search – query, tags, namespace로 메모리를 검색합니다. limit 지원(기본값 10).
• memory_get_last – 마지막 세션 체크포인트(system/last_memory)를 검색하여 에이전트가 작업을 중단한 위치를 알 수 있습니다.

네임스페이스 격리 및 설정

메모리는 네임스페이스(예: user/preferences, project/architecture)로 범위가 지정되어 컨텍스트를 분리합니다. 설정은 단일 명령으로 완료됩니다:

python3 setup.py

이 명령은 설치된 MCP 도구(Antigravity, Claude, Cursor, Windsurf, Codex)를 자동 구성합니다. 서버는 모든 도구에 대해 project_root 매개변수를 지원하므로 프로젝트별 메모리 저장소를 유지할 수 있습니다.

대상 사용자

AI 코딩 에이전트(Claude, Cursor 등)를 사용하는 개발자로서 일반 텍스트 Markdown에 유지되는 영구적이고 검색 가능한 메모리를 원하고 벡터 DB나 외부 서비스가 필요 없는 개발자를 대상으로 합니다.