QMD CLI
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
- 30 724 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает и индексирует выбранные папки на диске
- Скачивает модели из сети при первом запуске
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/qmdОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает и индексирует выбранные папки на диске
- Скачивает модели из сети при первом запуске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
QMD индексирует папки с Markdown-файлами в коллекции и ищет по ним тремя способами: полнотекстово по BM25, по векторным эмбеддингам и гибридно с переранжированием моделью. Все модели в формате GGUF работают на вашей машине. К коллекциям можно добавлять описания контекста, которые возвращаются вместе с найденными документами и помогают агенту выбрать нужный файл. Результаты выдаются в JSON или списком файлов, а MCP-сервер дает агенту инструменты поиска и чтения документов.
Для кого. Для тех, кто держит заметки, базу знаний или документацию в Markdown и хочет, чтобы агент находил в них нужное без облака.
Подходит, если
- Агенту нужен поиск по большой базе заметок или документации
- Данные нельзя отправлять во внешние сервисы поиска
- Нужен смысловой поиск, а не только совпадение слов
Не подходит, если
- Файлов мало, и агенту хватает обычного grep
- Документы в форматах, отличных от текстовых, например PDF или сканы
Пример запроса к агенту
Найди в моих заметках все, что обсуждали про планирование кварталаОграничения
Нужен Node.js 22 и новее, на macOS еще SQLite из Homebrew. При первом запуске скачиваются три GGUF-модели с Hugging Face, а эмбеддинги и переранжирование нагружают процессор или видеокарту. Для лучшей работы с неанглийскими текстами README советует сменить модель эмбеддингов.
Как отключить. Удалите запись qmd из конфигурации MCP или плагин qmd в Claude Code, затем npm uninstall -g @tobilu/qmd. Индекс и модели лежат в ~/.cache/qmd.
Частые вопросы
Обязательно ли подключать MCP?
Нет. Агент может вызывать qmd в терминале, флаги --json и --files сделаны как раз для этого. MCP дает более плотную интеграцию.
Можно ли держать один сервер на несколько клиентов?
Да, команда qmd mcp --http запускает долгоживущий сервер на localhost:8181, чтобы модели не загружались заново для каждого клиента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMinutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
mcp-logseq — MCP-сервер для Logseq
MCP server for LogSeq
MCP-сервер для Logseq: агент читает, ищет и правит страницы и блоки графа через локальный HTTP API
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Шаблон vault в Obsidian с хуками, командами и скиллами, который дает Claude Code, Codex и Gemini CLI постоянную память между сессиями
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Коротко о README
README объясняет схему поиска: запрос расширяется, идет в полнотекстовый и векторный поиск, результаты сливаются и переранжируются моделью. Дальше описаны команды для коллекций, контекста и эмбеддингов, MCP-сервер с транспортами stdio и HTTP, плагин для Claude Code и использование как библиотеки для Node.js и Bun. Отдельно разобраны защита HTTP-сервера от чужих страниц и системные требования. Лицензия MIT.