Kensaku의 개요
Kensaku는 Windows, macOS, Linux용 오픈소스 데스크톱 검색 앱입니다. 파일 이름, PDF·Office 파일·EPUB·이메일과 50가지가 넘는 코드 및 데이터 형식 안의 텍스트, 스크린샷에서 OCR로 읽은 텍스트를 색인하고, 의미 검색을 위한 작은 임베딩 모델도 갖추고 있습니다. kensaku-cli 바이너리는 같은 로컬 색인을 검색하는 MCP 서버를 stdio로 실행하며, 루프백 HTTP로 제공할 수도 있습니다.
저장소는 GitHub 사용자 yjid가 2026년 10월 24일에 만들었고, 11월 11일 기준 스타 약 1,645개, 포크 107개였습니다. MIT 라이선스이며 Rust와 Tauri 인터페이스로 작성되었습니다. 2026년 11월 9일에 나온 버전 1.0.17은 비공개로 보고된 문제 5건을 고친 보안 릴리스이며, 그중 3건은 심각도 높음으로 분류되었습니다.
Kensaku 설치 방법
kensaku-cli mcp (kensaku-cli ships with each GitHub release)Kensaku, 쓸 만한 가치가 있습니까?
Kensaku는 대부분의 파일 서버가 주지 못하는 것을 에이전트에 줍니다. 파일 이름이 아니라 파일에 적힌 내용으로 검색하며, 문서, 코드, 스크린샷 속 텍스트까지 아우르고, 색인은 데스크톱 앱이 이미 최신 상태로 유지합니다. MCP 도구는 search, regex_search, Rust·Python·JavaScript·TypeScript의 tree-sitter 정의를 찾는 find_symbol, read_snippet, health_check, index_state입니다. 모두 읽기 전용입니다. reindex 도구도 있지만 숨겨져 있고 설정에서 mcp_allow_reindex를 켜지 않으면 꺼져 있으며, HTTP로는 절대 실행되지 않습니다.
응답은 컨텍스트 창에 맞게 설계되었습니다. 검색 스니펫은 100자로 제한되고, 페이지당 기본 10건, 최대 50건이며, read_snippet은 파일 전체가 아니라 첫 일치 지점을 중심으로 최대 1,024토큰을 돌려줍니다. 프로젝트 벤치마크에 따르면 100,000개 파일에 대한 이름 검색은 Windows 11 기본 스레드에서 평균 18 ms가 걸리고, 그 파일들의 메타데이터는 12.2 MB를 차지합니다. 쿼리 언어(type:pdf, modified:7d, re:"...")는 search 도구에 그대로 전달됩니다.
주의할 점: 나이입니다. 저장소는 2026년 10월 24일에 만들어졌고, 11월 9일의 1.0.17은 보안 권고 5건을 고쳤습니다. 검색 범위와 find_symbol을 통해 에이전트 루트 제한을 우회할 수 있던 문제, 색인된 적 없는 제외 파일을 read_snippet이 읽던 문제, 공격자가 소유한 스테이징 디렉터리를 Linux 업데이터가 받아들이던 문제 등이 포함됩니다. 빠르게 고치고 권고를 공개한 것은 좋은 신호지만, 첫 2주 동안 에이전트 경계에서 심각한 구멍이 3개나 나왔다는 것은 그 경계가 아직 다듬어지는 중이라는 뜻입니다. macOS와 Windows용 릴리스 빌드는 서명되어 있지 않습니다.
프롬프트 인젝션 노출 지점은 색인 자체입니다. 감시 중인 폴더의 텍스트는 내려받은 PDF나 다른 사람의 스크린샷까지 포함해 스니펫으로 에이전트에 돌아올 수 있습니다. 문서는 파일 내용이 지시가 아닌 데이터로 반환된다고 하지만, 그것은 출력에 붙은 라벨일 뿐 모델을 구속하는 필터가 아닙니다. .pem, .key 같은 자격 증명 파일, .ssh, .aws 같은 폴더, .env 파일은 기본적으로 거부되며, agent_scoped_roots로 에이전트가 볼 수 있 는 범위를 선택한 폴더로 좁힐 수 있습니다. 홈 디렉터리를 에이전트에 맡긴다면 반드시 설정해야 합니다.
제 역할을 하는 곳
지난주 배포 실패를 추적하는 백엔드 개발자
파일 이름을 기억하지 못해도 오류의 로그 줄과 스크린샷 찾기
에이전트에게 modified:7d를 붙여 오류 문구를 검색하게 합니다. Kensaku는 로그 파일과 OCR 처리된 스크린샷에서 일치 항목을 경로와 함께 돌려주고, read_snippet이 앞뒤 줄을 가져옵니다. 무료이며 색인은 데스크톱 앱이 이미 만들어 두었습니다.
노트북에 수년치 고객 PDF와 발표 자료를 둔 컨설턴트
특정 가격 모델을 언급한 제안서를 모두 모으기
agent_scoped_roots를 고객 폴더로 설정한 뒤, 에이전트에게 type:pdf로 거른 내용 검색을 실행하고 스니펫을 바탕으로 결과를 요약하게 합니다. 에이전트 자체의 모델 제공업체가 보는 내용 말고는 컴퓨터 밖으로 나가지 않습니다.
여러 언어가 섞인 큰 저장소에 새로 합류한 엔지니어
여러 프로젝트에서 함수나 구조체가 어디에 정의되어 있는지 찾기
언어 필터를 건 find_symbol로 경로, 줄 범위, 시그니처를 얻고 해당 파일만 엽니다. 홈 디렉터리 전체를 grep하는 것보다 빠르며, 호출 한 번에 분석하는 파일은 200개로 제한됩니다.
도입 전 확인할 점
- 설정
- GitHub 릴리스에서 자신의 플랫폼용 앱 번들을 내려받고(서명되지 않았으므로 SmartScreen이나 Gatekeeper 경고가 뜹니다), 첫 실행 때 폴더와 제외 항목을 고른 다음 MCP 클라이언트를 kensaku-cli mcp로 지정합니다. Settings의 Agents에서 Claude Desktop, Claude Code, Cursor용 항목을 .bak 백업과 함께 써 줄 수 있습니다.
- 연동
- 보이는 도구는 search, regex_search, find_symbol, read_snippet, health_check, index_state 6개이고, 선택적으로 reindex가 있습니다. 기본은 stdio이며, kensaku-cli serve를 쓰면 루프백 포트 8765에서 bearer 토큰을 쓰는 MCP Streamable HTTP가 추가됩니다.
- 데이터와 개인정보
- 선택한 폴더의 색인(파일 이름과 추출한 텍스트)을 읽으며, 도구는 파일을 바꿀 수 없습니다. 텔레메트리는 없고, 외부로 나가는 통신은 업데이트 확인과 모델 또는 OCR 팩 다운로드뿐입니다. HTTP 모드는 루프백 포트를 열고 토큰을 <config>/http.token에 저장합니다. 색인된 텍스트는 에이전트에게 신뢰할 수 없는 입력입니다. 보안 권고 5건(3건 높음)은 1.0.17에서 수정되었습니다.
- 대규모 사용 시 비용
- 무료입니다. 비용은 로컬 자원이며, 프로젝트의 Linux 기준 실행에서 약 101,000개의 혼합 파일을 처음 색인하는 데 184 s, 최대 메모리 183 MB가 들었습니다.
- 제한
- 열린 이슈는 약 16개입니다. 전수 모드는 한 번 순회할 때 10,000건이 상한이고, find_symbol은 4개 언어만 지원하며, JPEG 2000·팩스·JBIG2 스캔은 디코딩하지 않습니다. 시각 검색은 검색 결과와 별개인 베타 다운로드입니다. 실사용 테스트가 가장 많은 플랫폼은 Windows입니다.
좋은 점
- 이름뿐 아니라 문서 텍스트, OCR, 의미로 검색
- 읽기 전용 도구, reindex는 기본적으로 꺼짐
- 토큰 예산을 둔 스니펫과 페이지 나누기
- 계정, 텔레메트리, 클라우드 검색 없음
아쉬운 점
- 첫 몇 주 만에 보안 권고 5건 수정
- macOS와 Windows 빌드는 서명되지 않음
- 색인된 텍스트가 에이전트에 프롬프트 인젝션을 전달할 수 있음
- 시각 검색은 아직 검색 결과에 포함되지 않음
추천 대상
Claude나 Cursor가 자기 컴퓨터의 파일을 내용으로 찾게 하고 싶고, 에이전트 범위를 선택한 폴더로 제한할 개발자와 지식 노동자에게 맞습니다.
Kensaku 대안
Kensaku: 자주 묻는 질문
- Kensaku, 쓸 만한 가치가 있습니까?
- 에이전트가 내 디스크에 있는 것을 내용으로 찾게 하는 빠른 방법이지만, 만들어진 지 겨우 3주 남짓이고 첫 보안 릴리스가 막 나온 프로젝트입니다. 평점은 5점 만점에 3.7점입니다.
- Kensaku의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. 유료 요금제, 계정, 클라우드 서비스가 없습니다.
- Kensaku의 단점은 무엇입니까?
- 첫 몇 주 만에 보안 권고 5건 수정; macOS와 Windows 빌드는 서명되지 않음; 색인된 텍스트가 에이전트에 프롬프트 인젝션을 전달할 수 있음; 시각 검색은 아직 검색 결과에 포함되지 않음.
- Kensaku에 적합한 사람은 누구입니까?
- Claude나 Cursor가 자기 컴퓨터의 파일을 내용으로 찾게 하고 싶고, 에이전트 범위를 선택한 폴더로 제한할 개발자와 지식 노동자에게 맞습니다.
- 팀이나 프로덕션 환경에서 Kensaku의 비용은 얼마입니까?
- 무료입니다. 비용은 로컬 자원이며, 프로젝트의 Linux 기준 실행에서 약 101,000개의 혼합 파일을 처음 색인하는 데 184 s, 최대 메모리 183 MB가 들었습니다.
- Kensaku에 회사 데이터를 맡겨도 안전합니까?
- 선택한 폴더의 색인(파일 이름과 추출한 텍스트)을 읽으며, 도구는 파일을 바꿀 수 없 습니다. 텔레메트리는 없고, 외부로 나가는 통신은 업데이트 확인과 모델 또는 OCR 팩 다운로드뿐입니다. HTTP 모드는 루프백 포트를 열고 토큰을 <config>/http.token에 저장합니다. 색인된 텍스트는 에이전트에게 신뢰할 수 없는 입력입니다. 보안 권고 5건(3건 높음)은 1.0.17에서 수정되었습니다.
- Kensaku의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Filesystem (reference server), Zvec-Grep (zg) 및 Paperless-NGX MCP Server입니다.
답변 확인일: 2026년 11월 11일.