무료 오픈소스 로컬 파일 검색 런처: 파일 이름, 파일 본문(PDF, DOCX, EPUB 등), 스크린샷의 텍스트(OCR) 및 시맨틱 검색을 동시에 지원하며, MCP를 통해 Claude, Cursor 등의 에이전트가 동일한 인덱스를 읽기 전용으로 검색할 수 있습니다.
스타 수 221 (+216 / 24시간)
이유
- 저자는 Linux에서 10만 개의 파일을 대상으로 파일 이름 검색 시 평균 1.3밀리초가 소요되며, 파일 이름 및 메타데이터는 약 12MB의 메모리를 차지한다고 밝혔습니다. 최초 인덱싱 시 101101개의 파일을 처리하는 데 184초가 걸렸습니다.
- 자연어 시간 표현("지난주 스크린샷") 및 쿼리 문법(type:pdf, size:>10mb, modified:7d, re: 정규식 등)을 지원합니다. OCR은 기본적으로 PP-OCRv6를 사용하며, Intel Mac에서는 Tesseract로 대체됩니다.
- MCP는 기본적으로 읽기 전용이며 재인덱싱(reindex)은 기본적으로 비활성화되어 있습니다. 반환되는 콘텐츠에는 크기 제한이 있으며 데이터 기반으로 처리되고 지시문으로 간주되지 않습니다. 텔레메트리는 수집하지 않으며, .pem, .key 등 자격 증명 파일은 기본적으로 인덱싱되지 않습니다.
사용법
- Releases에서 Windows exe / msi, macOS 범용 dmg 또는 Linux AppImage / deb / rpm을 다운로드합니다. 최초 실행 시 인덱싱할 폴더를 선택하며, OCR 및 모델 팩을 선택적으로 다운로드할 수 있습니다.
- MCP 클라이언트에서 command를 kensaku-cli로, args를 ["mcp"]로 설정합니다. HTTP를 사용하는 클라이언트의 경우 kensaku-cli serve를 사용하며(로컬 호스트만 수신, 토큰 필요),
리스크
- 설치 패키지에 아직 코드 서명이 되어 있지 않아 macOS와 Windows에서 최초 실행 시 경고가 표시됩니다. 자동 업데이트 기능은 아직 연결되지 않았습니다.
- 인덱스에는 파일 이름과 추출된 본문이 포함되므로, 저자는 공유 위치로 동기화하지 않도록 주의할 것을 권고합니다. 성능 수치는 저자가 Linux에서 자체 테스트한 결과이며 Spotlight나 Everything과의 비교는 이루어지지 않았습니다. 저장소는 10월 24일에 생성되었으며 라이선스는 MIT입니다.