claude-lens

Claude Code에 모든 과거 세션에 걸쳐 검색 가능한 메모리를 제공하는 MCP 서버입니다.

모든 Claude Code 세션 JSONL 파일을 FTS5 전문 검색이 적용된 SQLite 데이터베이스로 인덱싱합니다. Claude는 대화를 검색하고, 과거 도구 호출을 찾고, 프로젝트나 날짜로 필터링하고, 이전에 해결한 오류를 조회할 수 있는 도구를 얻게 됩니다.

작동 방식

Claude Code는 세션을 ~/.claude/projects/ 디렉터리에 JSONL 파일로 저장합니다. claude-lens는 시작 시 이 파일들을 파싱하여 FTS5 검색 인덱스를 구축하고 MCP를 통해 9개의 도구를 노출합니다. Claude의 에이전트 루프가 언제 자신의 기록을 검색할지 결정합니다 — 수동 호출은 필요 없습니다.

이것은 수동적 RAG가 아니라 능동적 회상입니다. Claude는 무엇을 검색할지 결정하고, 결과를 읽은 후 후속 질문으로 더 깊이 파고들 수 있습니다. 인간이 검색 엔진을 사용하는 것과 같은 패턴입니다 — 여러 번의 목표 지향적 검색이 한 번의 맹목적 검색보다 낫습니다.

Related MCP server: conversation-search

도구

설치

git clone https://github.com/jasonpaulmichaels/claude-lens.git
cd claude-lens
bash scripts/install.sh

또는 수동으로:

# Sync repo to runtime install location
rsync -a --exclude=node_modules --exclude=.git --exclude=test \
  ./ ~/.claude/mods/claude-lens/
cd ~/.claude/mods/claude-lens && npm install --omit=dev

# Register MCP server (user scope so it's available everywhere)
claude mcp add -s user claude-lens -- node ~/.claude/mods/claude-lens/src/index.js

install.sh 스크립트가 이 작업을 대신 처리합니다. 소스 저장소는 런타임 설치와 분리되어 있습니다 — 소스를 편집한 다음 install.sh를 다시 실행하여 배포하세요.

설치 후 Claude Code를 다시 시작하세요. 첫 번째 시작 시 모든 세션이 인덱싱됩니다(몇 분 소요). 이후 시작은 증분 방식입니다(5초 미만).

사용법

Claude Code를 평소처럼 사용하기만 하면 됩니다. 과거 세션의 맥락이 도움이 될 때 Claude가 자동으로 검색합니다. 직접 물어볼 수도 있습니다:

• "지난주에 무엇을 작업하고 있었지?"

• "betterclaw에서 인증 버그를 어떻게 고쳤지?"

• "cloudflare tunnel을 설정한 세션을 찾아줘"

• "커널 모듈을 다시 빌드하기 위해 어떤 명령을 실행했지?"

• "listforge 작업 중 겪은 오류를 보여줘"

요구 사항

• Node.js 20+

• MCP를 지원하는 Claude Code

데이터

• 세션 인덱스 위치: ~/.claude/projects/

• 데이터베이스 저장 위치: ~/.claude-lens/claude-lens.db

• 하위 에이전트 세션은 건너뜁니다

• 도구 출력은 DB를 관리 가능한 크기로 유지하기 위해 500자로 잘립니다

• 파일 mtime 추적을 통한 증분 인덱싱

라이선스

MIT