Локальный семантический поиск по заметкам: MCP-сервер для Claude Code без облака и платных API

Обычный поиск по тексту не справляется, когда в конспекте написано «собеседование» и «кандидат», а вы помните обсуждение найма. Чтобы искать по смыслу, не выгружая заметки в облако, автор поднял локальный семантический поиск и оформил его как MCP-сервер для Claude Code.

Вся работа идёт на своей машине: никаких платных API и внешних эмбеддингов, данные не покидают компьютер. В статье разобрано, как устроен движок и сервер, а также три места, где легко споткнуться: модель молча обрезает текст, лишний вывод в стандартный поток ломает протокол, и нужна проверка пути в инструменте чтения.

Отдельно показан кэш, который сам понимает, когда устарел. Код взят из рабочих файлов, всё лишнее убрано.