Obsidian Hybrid Search MCP
obsidian-hybrid-search
Локальный поиск по хранилищу Obsidian: агент находит заметки по смыслу, словам, тегам и ссылкам через MCP, CLI или плагин.
- 118 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер читает все заметки хранилища и передает их содержимое агенту.
- При удаленных эмбеддингах текст заметок уходит во внешний API.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/obsidian-hybrid-searchОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает все заметки хранилища и передает их содержимое агенту.
- При удаленных эмбеддингах текст заметок уходит во внешний API.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Один поисковый движок доступен тремя способами: MCP-сервер для агента, CLI `ohs` и плагин для самого Obsidian. Результаты объединяют семантический поиск, BM25 по тексту, нечеткое сопоставление заголовков и алиасов, фильтры по тегам, папкам и frontmatter. У каждой заметки в ответе есть исходящие ссылки и обратные ссылки. MCP-сервер дает три инструмента: `search`, `read` и `reindex`. Индекс хранится в SQLite с FTS5 и sqlite-vec, эмбеддинги считаются локально моделью `Xenova/multilingual-e5-small`, а при желании берутся из OpenAI-совместимого API. Индекс обновляется постепенно и следит за правками файлов.
Для кого. Владельцы больших хранилищ Obsidian, которые хотят, чтобы Claude Code или Claude Desktop искали по их заметкам, а не по тому, что вставлено в чат.
Подходит, если
- Агент отвечает на вопрос и должен опереться на ваши заметки со ссылками на файлы.
- Нужно найти похожие заметки и связи по графу: исходящие и обратные ссылки на заданной глубине.
- Заметки написаны на разных языках, а поиск должен понимать смысл фраз.
- Несколько клиентов должны делить один процесс индексации по HTTP.
Не подходит, если
- Заметки нельзя отдавать агенту: сервер читает содержимое хранилища.
- Нужен поиск по вложениям: индексируются заметки, а не файлы вроде PDF.
- Хранилище мало, и хватает встроенного поиска Obsidian.
Пример запроса к агенту
Найди в моем хранилище заметки про ретроспективы команды, покажи связанные заметки на глубину два и прочитай две самые близкие.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
OBSIDIAN_VAULT_PATHобязательная- Абсолютный путь к хранилищу Obsidian.
OBSIDIAN_PREFIX- Необязательный префикс названий инструментов MCP.
Ограничения
Первый запуск скачивает локальную модель около 117 МБ, переранжирование `--rerank` докачивает еще около 341 МБ. Для MCP обязателен `OBSIDIAN_VAULT_PATH`. При HTTP-режиме `ohs serve` сервер слушает `127.0.0.1:3939`, а при выходе за пределы локальной машины нужно перечислить разрешенные хосты: режим `--allow-any-host` отключает защиту заголовка Host. При удаленных эмбеддингах текст заметок уходит в выбранный API.
Как отключить. Уберите запись сервера из `.mcp.json` или `claude_desktop_config.json`, остановите `ohs serve`, удалите пакет и файл `.obsidian-hybrid-search.db` в хранилище.
Частые вопросы
Как подключить поиск к Claude Desktop или Claude Code?
Добавьте в `.mcp.json` или `claude_desktop_config.json` запись с командой `npx` и аргументами `-y -p obsidian-hybrid-search@latest obsidian-hybrid-search-mcp`, в `env` укажите `OBSIDIAN_VAULT_PATH`.
Нужен ли ключ API?
Нет. Эмбеддинги по умолчанию считаются локально. Ключ нужен только при выборе удаленного OpenAI-совместимого API.
Как добавить префикс к названиям инструментов?
Задайте `OBSIDIAN_PREFIX`, например `myvault_`: инструменты станут `myvault_search` и `myvault_read`. Это удобно, если подключено несколько хранилищ.
Как делить один индекс между клиентами?
Запустите `ohs serve`, затем укажите в клиенте адрес `http://127.0.0.1:3939/mcp`. Порт меняется флагом `--port`.
Какая модель считает эмбеддинги?
По умолчанию `Xenova/multilingual-e5-small`, больше 100 языков, загрузка около 117 МБ. Переранжирование `--rerank` использует `gte-multilingual-reranker-base`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Local REST API для Obsidian
Local REST API for Obsidian
Плагин Obsidian с защищенным REST API и встроенным MCP-сервером: агент читает, ищет и точечно правит заметки хранилища прямо из Claude Code или Cursor
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
MCP-сервер на Rust для хранилища Obsidian: поиск, граф ссылок, правка заметок с проверкой хеша и откатом по журналу.
CLI строит локальный индекс заметок с «катализаторами», вопросами по вашим записям, чтобы агент находил нужное лучше grep
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Obsidian Hybrid Search (эта карточка) | нет | не нужна | 118 | |
| Local REST API для Obsidian | нет | API-ключ | 3 116 | отдает REST API и MCP для чтения и правки заметок; Obsidian Hybrid Search специализируется на ранжированном поиске |
| obsidian-wiki | нет | 3 693 | набор скиллов для ведения вики; здесь поисковый движок с индексом и графом ссылок |
Коротко о README
Автор приводит замеры на трех наборах: справка Obsidian, публичные заметки Andy Matuschak и 22 419 заметок LongMemEval-S. На справке Obsidian у OHS nDCG@5 равен 0,733, у qmd 0,659.