CogniLayer: Claude Code용 영구 메모리 MCP 서버

CogniLayer는 Claude Code를 위해 특별히 제작된 MCP 서버로, 세션 간 지속적인 메모리를 제공합니다. 이 도구는 Claude Code가 새 세션을 시작할 때 프로젝트 아키텍처, 과거 결정, 디버깅 통찰력 등 모든 것을 잊어버려 사용자가 반복적으로 컨텍스트를 다시 설명해야 하는 문제를 해결합니다.

기술적 구현

이 시스템은 로컬에 지식을 저장하기 위해 SQLite 데이터베이스에 FTS5 전체 텍스트 검색과 벡터 임베딩(fastembed + sqlite-vec)을 사용합니다. 키워드 매칭과 의미적 벡터 유사도를 결합한 하이브리드 검색을 구현합니다.

주요 기능

• 14가지 유형의 사실 저장: 결정, 패턴, 주의사항, 오류 수정, API 계약 등
• 신선도 감지: 기억된 사실이 변경된 파일을 참조할 때 경고
• 세션 브리지: 세션 간 컨텍스트를 자동으로 전달
• 열 감쇠 시스템: 사실이 시간이 지남에 따라 노화됨(핫/웜/콜드), 자주 접근하는 정보는 관련성 유지
• 신분증 시스템: 잘못된 서버에 배포하는 것을 방지
• 3가지 훅: SessionStart, SessionEnd, PostToolUse
• 10가지 MCP 도구와 7가지 슬래시 명령어

설치 및 사용법

CogniLayer를 설치하고 사용하려면:

git clone https://github.com/LakyFx/CogniLayer.git
python install.py

Claude Code를 어떤 프로젝트에서든 시작한 후 /onboard 명령어를 실행하세요. 이 도구는 SQLite를 사용하여 완전히 로컬에서 실행되며 Windows, macOS, Linux에서 작동합니다.

이 프로젝트는 Claude Code 세션을 사용하여 구축되었으며, Claude가 데이터베이스 스키마 설계, MCP 서버 작성, 훅 시스템 구축, 하이브리드 검색 랭커 구현, 임베딩 파이프라인 반복 작업을 도왔습니다. 이 도구는 100% 무료이며 GPL v3 하에 오픈소스로 제공되며, UI 문자열은 현재 체코어로 되어 있지만 모든 언어와 함께 기능합니다.