Claude Code로 구축한 자가 호스팅 MCP 메모리 서버 'Zikra' 공개

실용적 조언

Claude Code 세션 종료 시 자동 저장을 원한다면 Stop hook 기능을 활용하여 외부 DB나 파일에 컨텍스트를 전송하는 스크립트를 연동하십시오.
다양한 IDE를 병행 사용한다면 MCP 표준 서버를 구축하여 도구 간 컨텍스트 동기화 문제를 해결할 수 있습니다.

섹션별 상세

Claude Code와 Claude Web은 컨텍스트를 공유하지 않아 매 세션이 0에서 시작되는 한계가 존재한다. 작성자는 팀원들이 합류할 때 정보 파편화가 심화되는 문제를 해결하고자 Zikra를 개발했다. 모든 결정 사항, 오류, 요구 사항을 세션 종료 시점에 자동으로 저장하여 영구적인 지식 베이스를 구축한다. 실무적으로는 반복적인 컨텍스트 주입 시간을 줄여 개발 효율성을 높인다.

Claude Code의 Stop hook 기능을 기술적 핵심으로 활용하여 세션 종료 시 자동 저장을 구현했다. 사용자가 수동으로 저장 명령을 내리지 않아도 세션이 닫히는 시점에 훅이 트리거되어 데이터를 서버로 전송한다. 저장된 데이터는 MCP(Model Context Protocol) 표준을 따르므로 Claude Desktop이나 Cursor 같은 다른 도구에서도 즉시 접근 가능하다. 이는 다양한 개발 환경에서 일관된 AI 메모리를 유지하게 해준다.

시스템 구축을 위해 Python 기반의 zikra-lite 패키지를 배포하고 로컬 서버 환경을 구성했다. 사용자는 pip 설치 후 mcp.json 설정 파일에 서버 엔드포인트와 인증 토큰을 추가하는 과정으로 연동을 마칠 수 있다. GitHub에 공개된 프롬프트 지침을 Claude Code에 주입하면 모델이 스스로 메모리 서버와 통신하는 방식을 학습한다. MIT 라이선스 기반의 오픈소스로 제공되어 누구나 제약 없이 커스터마이징이 가능하다.

bash

pip install zikra-lite && python -m zikra

Zikra-lite 서버 설치 및 실행 명령

json

{"zikra": {"url": "http://localhost:7723/mcp", "headers": {"Authorization": "Bearer YOUR_TOKEN"}}}

mcp.json 설정 파일에 Zikra 서버를 등록하는 예시

용어 해설

모델 컨텍스트 프로토콜(MCP): — Anthropic이 제안한 개방형 표준으로, AI 모델이 로컬 데이터나 외부 도구와 안전하게 연결될 수 있도록 하는 통신 규약이다. 이를 통해 서로 다른 AI 도구 간에 데이터 소스를 공유하고 통합된 워크플로를 구축할 수 있다.
중단 훅(Stop Hook): — 프로그램이나 세션이 종료되는 시점에 특정 작업이 실행되도록 설정된 트리거 메커니즘이다. 이 글에서는 Claude Code 세션이 닫힐 때 현재까지의 대화 맥락을 서버에 자동으로 전송하여 저장하는 용도로 사용된다.
자가 호스팅(Self-hosting): — 클라우드 서비스 제공자의 서버 대신 사용자가 직접 관리하는 로컬 서버나 인프라에 소프트웨어를 설치하고 운영하는 방식이다. 데이터에 대한 완전한 제어권을 가질 수 있어 보안과 프라이버시가 중요한 개발 환경에서 선호된다.

언급된 도구

Claude Code추천

AI 코딩 에이전트 및 CLI 도구

Zikra추천

자가 호스팅 MCP 메모리 서버

MCP추천

모델과 데이터 간의 통신 프로토콜

언급된 리소스

GitHubZikra-lite GitHub Repository

GitHubZikra Team Version GitHub Repository