¿Qué es Kensaku?
Kensaku es una aplicación de búsqueda de escritorio de código abierto para Windows, macOS y Linux que indexa nombres de archivo, el texto dentro de PDF, archivos de Office, EPUB, correo y más de 50 formatos de código y datos, el texto que el OCR lee en capturas de pantalla y un pequeño modelo de embeddings para buscar por significado. Su binario kensaku-cli ejecuta un servidor MCP por stdio que busca en el mismo índice local, y también puede servirlo por HTTP en loopback.
El repositorio, del usuario de GitHub yjid, se creó el 24 de octubre de 2026 y tenía unas 1.645 estrellas y 107 forks el 11 de noviembre. Tiene licencia MIT y está escrito en Rust con una interfaz Tauri. La versión 1.0.17, publicada el 9 de noviembre de 2026, es una versión de seguridad que corrigió cinco fallos comunicados en privado, tres de ellos de gravedad alta.
Cómo instalar Kensaku
kensaku-cli mcp (kensaku-cli ships with each GitHub release)¿Merece la pena Kensaku?
Kensaku le da a un agente algo que la mayoría de los servidores de archivos no ofrecen: buscar por lo que dice un archivo y no por cómo se llama, en documentos, código y el texto dentro de capturas de pantalla, a partir de un índice que una aplicación de escritorio ya mantiene al día. Las herramientas MCP son search, regex_search, find_symbol para definiciones tree-sitter en Rust, Python, JavaScript y TypeScript, read_snippet, health_check e index_state. Todas son de solo lectura. Existe una herramienta reindex, pero está oculta y desactivada salvo que fijes mcp_allow_reindex en la configuración, y nunca se ejecuta por HTTP.
Las respuestas están pensadas para una ventana de contexto. Los fragmentos de búsqueda se limitan a 100 caracteres, las páginas traen 10 resultados por defecto y se detienen en 50, y read_snippet devuelve como máximo 1.024 tokens centrados en la primera coincidencia en lugar de un archivo entero. Según las pruebas del proyecto, una búsqueda por nombre en 100.000 archivos tarda de media 18 ms en Windows 11 con los hilos por defecto, y los metadatos de esos archivos ocupan 12,2 MB. El lenguaje de consulta (type:pdf, modified:7d, re:"...") pasa tal cual por la herramienta de búsqueda.
La pega: la edad. El repositorio se creó el 24 de octubre de 2026, y la 1.0.17 del 9 de noviembre corrigió cinco avisos, entre ellos restricciones de raíz del agente que podían saltarse mediante ámbitos de búsqueda y find_symbol, un read_snippet que leía archivos excluidos que nunca se indexaron y un actualizador de Linux que aceptaba un directorio temporal controlado por un atacante. Corregirlos deprisa y publicar los avisos es buena señal; encontrar tres agujeros graves en la frontera del agente en las dos primeras semanas indica que esa frontera aún se está definiendo. Las versiones publicadas no están firmadas en macOS ni en Windows.
La exposición a inyección de prompts es el propio índice. Cualquier texto que haya en una carpeta vigilada, incluidos PDF descargados y capturas de otras personas, puede volver al agente en un fragmento. La documentación dice que el contenido de los archivos se devuelve como datos, nunca como instrucciones, pero eso es una etiqueta en la salida, no un filtro que obligue al modelo. Los archivos de credenciales como .pem y .key, carpetas como .ssh y .aws y los archivos .env se deniegan por defecto, y agent_scoped_roots limita lo que ve un agente a las carpetas elegidas; quien apunte un agente a su carpeta personal debería configurarlo.
Dónde se gana su sitio
Un desarrollador backend que persigue un fallo de despliegue de la semana pasada
Encontrar la línea de log y la captura del error sin recordar nombres de archivo
Pide al agente que busque el texto del error con modified:7d; Kensaku devuelve coincidencias de archivos de log y de capturas pasadas por OCR con sus rutas, y read_snippet trae las líneas de alrededor. Gratis; la aplicación de escritorio ya ha construido el índice.
Un consultor con años de PDF y presentaciones de clientes en el portátil
Reunir todas las propuestas que mencionan un modelo de precios concreto
Fija agent_scoped_roots en la carpeta de clientes y haz que el agente lance una búsqueda de contenido filtrada a type:pdf y resuma los resultados a partir de los fragmentos. Nada sale del equipo salvo lo que ve el proveedor de modelos del propio agente.
Una ingeniera recién llegada a un repositorio grande y multilenguaje
Localizar dónde se define una función o un struct en varios proyectos
Usa find_symbol con un filtro de lenguaje para obtener la ruta, el rango de líneas y la firma, y abre solo esos archivos. Más rápido que un grep completo sobre la carpeta personal, con un límite de 200 archivos analizados por llamada.
Antes de decidirte
- Puesta en marcha
- Descarga el paquete de la aplicación para tu plataforma desde las releases de GitHub (sin firmar, así que espera un aviso de SmartScreen o Gatekeeper), elige carpetas y exclusiones en el primer arranque y apunta un cliente MCP a kensaku-cli mcp. En Settings, Agents puede escribir la entrada para Claude Desktop, Claude Code y Cursor con una copia .bak.
- Integraciones
- Seis herramientas visibles: search, regex_search, find_symbol, read_snippet, health_check e index_state, más un reindex opcional. Stdio por defecto; kensaku-cli serve añade MCP Streamable HTTP en el puerto de loopback 8765 con un token bearer.
- Datos y privacidad
- Lee el índice de las carpetas que elijas, que contiene nombres de archivo y texto extraído; las herramientas no pueden modificar archivos. Sin telemetría; el tráfico saliente es una comprobación de actualizaciones y la descarga de paquetes de modelos u OCR. El modo HTTP abre un puerto de loopback con un token guardado en <config>/http.token. El texto indexado es entrada no fiable para el agente. La 1.0.17 corrigió cinco avisos (tres graves).
- Coste a escala
- Gratis. El coste es local: un primer índice de unos 101.000 archivos variados tardó 184 s con un pico de 183 MB en la prueba de referencia del proyecto en Linux.
- Límites
- Unos 16 issues abiertos. El modo exhaustivo se limita a 10.000 resultados por recorrido; find_symbol cubre cuatro lenguajes; no se decodifican escaneos JPEG 2000, fax ni JBIG2; la búsqueda visual es una descarga beta fuera de los resultados. Windows es la plataforma con más pruebas reales.
Lo bueno
- Busca en texto de documentos, OCR y significado, no solo en nombres
- Herramientas de solo lectura; reindex desactivado por defecto
- Fragmentos con presupuesto de tokens y paginación
- Sin cuenta, telemetría ni búsqueda en la nube
Lo malo
- Cinco avisos de seguridad corregidos en sus primeras semanas
- Versiones sin firmar en macOS y Windows
- El texto indexado puede llevar inyección de prompts al agente
- La búsqueda visual aún no forma parte de los resultados
Ideal para
Desarrolladores y trabajadores del conocimiento que quieren que Claude o Cursor encuentren archivos en su propio equipo por su contenido, y que limitarán el agente a carpetas elegidas.
Alternativas a Kensaku
Kensaku: preguntas frecuentes
- ¿Merece la pena Kensaku?
- Una forma rápida de que un agente encuentre por contenido lo que hay en tu propio disco, de un proyecto con apenas tres semanas cuya primera versión de seguridad acaba de llegar. Le damos un 3.7 sobre 5.
- ¿Cuánto cuesta Kensaku?
- Gratuito y de código abierto (MIT). Sin plan de pago, cuenta ni servicio en la nube.
- ¿Qué inconvenientes tiene Kensaku?
- Cinco avisos de seguridad corregidos en sus primeras semanas; versiones sin firmar en macOS y Windows; el texto indexado puede llevar inyección de prompts al agente; la búsqueda visual aún no forma parte de los resultados.
- ¿Para quién es Kensaku?
- Desarrolladores y trabajadores del conocimiento que quieren que Claude o Cursor encuentren archivos en su propio equipo por su contenido, y que limitarán el agente a carpetas elegidas.
- ¿Cuánto cuesta Kensaku para un equipo o en producción?
- Gratis. El coste es local: un primer índice de unos 101.000 archivos variados tardó 184 s con un pico de 183 MB en la prueba de referencia del proyecto en Linux.
- ¿Es Kensaku seguro para los datos de la empresa?
- Lee el índice de las carpetas que elijas, que contiene nombres de archivo y texto extraído; las herramientas no pueden modificar archivos. Sin telemetría; el tráfico saliente es una comprobación de actualizaciones y la descarga de paquetes de modelos u OCR. El modo HTTP abre un puerto de loopback con un token guardado en <config>/http.token. El texto indexado es entrada no fiable para el agente. La 1.0.17 corrigió cinco avisos (tres graves).
- ¿Cuáles son las mejores alternativas a Kensaku?
- Las alternativas más cercanas que hemos analizado son Filesystem (reference server), Zvec-Grep (zg) y Paperless-NGX MCP Server.
Respuestas comprobadas el 11 nov 2026.