Obsidian Hybrid Search — MCP-сервер для Claude Code: поиск по заметкам
MCP-сервер даёт агенту доступ к хранилищу Obsidian: ищет заметки по смыслу, заголовку и связям, читает их и отдаёт цитаты из ваших файлов.
claude mcp add --env OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> --env OBSIDIAN_PREFIX=<OBSIDIAN_PREFIX> --env OBSIDIAN_IGNORE_PATTERNS=<OBSIDIAN_IGNORE_PATTERNS> --env OBSIDIAN_RESPECT_GITIGNORE=<OBSIDIAN_RESPECT_GITIGNORE> --env OBSIDIAN_INCLUDE_PATTERNS=<OBSIDIAN_INCLUDE_PATTERNS> --transport stdio obsidian-hybrid-search -- npx -y obsidian-hybrid-searchЧто делает Obsidian Hybrid Search
Obsidian Hybrid Search объединяет несколько способов поиска в одном движке: BM25 по полному тексту, нечёткое совпадение по заголовкам и алиасам, семантические эмбеддинги и обход графа ссылок. Результаты сливаются через RRF, поэтому заметка всплывает наверх, даже если вы не помните точных слов. Есть четыре режима для текстовых запросов: hybrid, semantic, fulltext и title.
Агенту доступны чтение заметок по пути внутри хранилища, поиск похожих заметок и переход по связям с фильтром по направлению (outgoing, backlinks, both). Индексация инкрементальная: переиндексируются только изменённые файлы. Локальные эмбеддинги работают офлайн через @huggingface/transformers, модель по умолчанию — Xenova/multilingual-e5-small. Можно подключить OpenAI-совместимый API вроде OpenRouter или Ollama.
Для запуска нужен путь к хранилищу в OBSIDIAN_VAULT_PATH. Удалённые эмбеддинги требуют OPENAI_API_KEY, без него сервер работает на локальной модели. Опциональный --rerank тянет gte-multilingual-reranker-base (ONNX int8, около 341 MB) и заметно замедляет выдачу — включайте, когда важнее точность на концептуальных запросах.
Какие задачи решает
- найти заметку по смыслу, не помня точных формулировок
- подтянуть цитаты из хранилища Obsidian в ответ агента
- перейти от одной заметки к связанным по ссылкам
- отфильтровать выдачу по тегу или подпапке
- прочитать несколько заметок по путям за один вызов
Примеры запросов агенту
- Найди в хранилище заметки про инкрементальную индексацию и покажи цитаты
- Покажи заметки, связанные с
notes/dev/architecture.md, на два уровня вглубь - Найди похожие заметки на
notes/ideas/retrieval.md
Как установить Obsidian Hybrid Search
Командой платформы
claude mcp add --env OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> --env OBSIDIAN_PREFIX=<OBSIDIAN_PREFIX> --env OBSIDIAN_IGNORE_PATTERNS=<OBSIDIAN_IGNORE_PATTERNS> --env OBSIDIAN_RESPECT_GITIGNORE=<OBSIDIAN_RESPECT_GITIGNORE> --env OBSIDIAN_INCLUDE_PATTERNS=<OBSIDIAN_INCLUDE_PATTERNS> --transport stdio obsidian-hybrid-search -- npx -y obsidian-hybrid-searchВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add obsidian-hybrid-search --env OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> --env OBSIDIAN_PREFIX=<OBSIDIAN_PREFIX> --env OBSIDIAN_IGNORE_PATTERNS=<OBSIDIAN_IGNORE_PATTERNS> --env OBSIDIAN_RESPECT_GITIGNORE=<OBSIDIAN_RESPECT_GITIGNORE> --env OBSIDIAN_INCLUDE_PATTERNS=<OBSIDIAN_INCLUDE_PATTERNS> -- npx -y obsidian-hybrid-searchВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"obsidian-hybrid-search": {
"command": "npx",
"args": [
"-y",
"obsidian-hybrid-search"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
"OBSIDIAN_PREFIX": "<OBSIDIAN_PREFIX>",
"OBSIDIAN_IGNORE_PATTERNS": "<OBSIDIAN_IGNORE_PATTERNS>",
"OBSIDIAN_RESPECT_GITIGNORE": "<OBSIDIAN_RESPECT_GITIGNORE>",
"OBSIDIAN_INCLUDE_PATTERNS": "<OBSIDIAN_INCLUDE_PATTERNS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"obsidian-hybrid-search": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obsidian-hybrid-search"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
"OBSIDIAN_PREFIX": "<OBSIDIAN_PREFIX>",
"OBSIDIAN_IGNORE_PATTERNS": "<OBSIDIAN_IGNORE_PATTERNS>",
"OBSIDIAN_RESPECT_GITIGNORE": "<OBSIDIAN_RESPECT_GITIGNORE>",
"OBSIDIAN_INCLUDE_PATTERNS": "<OBSIDIAN_INCLUDE_PATTERNS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -e OBSIDIAN_PREFIX=<OBSIDIAN_PREFIX> -e OBSIDIAN_IGNORE_PATTERNS=<OBSIDIAN_IGNORE_PATTERNS> -e OBSIDIAN_RESPECT_GITIGNORE=<OBSIDIAN_RESPECT_GITIGNORE> -e OBSIDIAN_INCLUDE_PATTERNS=<OBSIDIAN_INCLUDE_PATTERNS> obsidian-hybrid-search npx -y obsidian-hybrid-searchВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Obsidian Hybrid Search
Как установить Obsidian Hybrid Search в Claude Code?
Выполните `claude mcp add obsidian-hybrid-search -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -e OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y obsidian-hybrid-search`. Подставьте свой путь к хранилищу и ключ API.
Что делает Obsidian Hybrid Search?
Даёт агенту поиск по хранилищу Obsidian: полный текст, семантика, заголовки и алиасы, связи между заметками. Плюс чтение заметок и поиск похожих.
Нужен ли ключ API для работы?
Нет, локальные эмбеддинги работают офлайн через @huggingface/transformers. OPENAI_API_KEY нужен только для OpenAI-совместимого API вроде OpenRouter или Ollama.
