zikra

Zikra는 Claude Code 및 기타 AI 코딩 에이전트와 함께 사용하기 위한 MCP 네이티브 영구 메모리 서버입니다. README는 여러 에이전트, 사람, 프로젝트를 운영하는 팀을 위한 공유되고 관리되는 메모리 레이어로 이를 소개합니다. 서버는 로컬에서 실행할 수 있으며, 기본적으로 localhost:8000에 바인딩되고 Bearer 토큰 인증을 사용합니다. URL과 Authorization 헤더를 통해 Claude Code에 MCP 서버로 추가할 수 있으며, 프로젝트는 대화형 설치 프로그램과 업데이트 스크립트를 제공합니다. 주요 기능으로는 다중 에이전트 지원(Claude Code, Gemini CLI, Codex, 또는 POST 가능한 모든 에이전트), 소유자, 관리자, 개발자, 뷰어 역할을 포함한 역할 기반 액세스, 그리고 프로젝트별로 별도의 메모리 풀을 유지할 수 있는 격리된 프로젝트 네임스페이스가 있습니다. 메모리는 일반 텍스트가 아닌 구조화되어 있으며, 명령 세트에는 메모리와 프롬프트 저장, 실행 및 오류 로깅, 요구 사항 저장 및 나열, 요구 사항 유형 승격, 제목 또는 ID로 항목 검색이 포함됩니다. 검색은 임베딩이 활성화된 경우 하이브리드 시맨틱과 키워드를 결합하며, OPENAI_API_KEY가 없는 경우 키워드 전용으로 대체됩니다. 순위는 연령, 액세스 빈도, 신뢰도 점수를 고려합니다. 스토리지는 로컬 또는 단일 사용자 설정을 위한 SQLite, 또는 팀 배포를 위한 PostgreSQL을 사용할 수 있습니다. PostgreSQL 백엔드는 DB_BACKEND 및 DB_* 환경 변수를 통해 구성되며, 추가적인 postgres 설치 옵션이 있습니다. 저장소 설명에는 pgvector와 n8n도 스택의 일부로 언급되어 있으며, 문서화된 웹훅 명령 엔드포인트는 /webhook/zikra입니다. 임베딩은 OpenAI 또는 호환 가능한 엔드포인트를 통해 OPENAI_API_BASE로 사용할 수 있습니다. 구성 옵션으로는 토큰, 데이터베이스 설정, 바인드 주소, 포트, 기본 프로젝트, 임베딩 모델, 감쇠 일수, 빈도 가중치가 있습니다. Claude Code의 경우, 설정 프롬프트는 Stop과 PreCompact 훅을 설치하고 상태 표시줄을 활성화하여 자동 세션 로깅을 가능하게 합니다. 내장된 위생 프롬프트는 신뢰도 감쇠, 고아 탐지, 오래된 항목 정리를 위해 설명되어 있습니다. 프로젝트는 MIT 라이선스입니다.