Obsidian Brain — MCP-сервер для Claude Code: поиск и правка заметок
Локальный MCP-сервер, который даёт агенту семантический поиск, граф связей и запись в хранилище Obsidian. Работает с обычными .md-файлами на диске.
claude mcp add --env VAULT_PATH=<VAULT_PATH> --env DATA_DIR=<DATA_DIR> --env EMBEDDING_PRESET=<EMBEDDING_PRESET> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --env EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> --transport stdio obsidian-brain -- npx -y obsidian-brainЧто делает Obsidian Brain
Obsidian Brain читает хранилище напрямую с диска, поэтому сам Obsidian может быть закрыт. Внутри один процесс Node: содержимое заметок разбирается на фрагменты по заголовкам, они ложатся в индекс SQLite вместе с полнотекстовым поиском FTS5. Режим search по умолчанию гибридный: смысловая выдача объединяется с BM25 через Reciprocal Rank Fusion.
Инструментов несколько групп. Чтение и поиск: search, list_notes, read_note. Граф: find_connections, find_path_between, detect_themes, rank_notes. Запись: create_note, edit_note, apply_edit_preview, link_notes, move_note, delete_note. Плюс служебные reindex и index_status. Правки сразу попадают на диск и переиндексируют затронутый файл.
Нужны Node 20+ и путь к хранилищу в переменной VAULT_PATH — без неё сервер не поднимется. При первом запуске он индексирует хранилище и скачивает модель эмбеддингов примерно на 34 MB, так что инструменты в клиенте появляются не мгновенно. Для локальных эмбеддингов есть провайдер Ollama, модель переключается через переменную окружения. Живой редактор, Dataview и Bases требуют отдельного плагина-компаньона, и его мажорная версия должна совпадать с версией сервера.
Какие задачи решает
- найти в хранилище нужный абзац по смыслу, а не по точному слову
- посмотреть, какие заметки связывают темы между собой
- поправить или создать заметку из чата с агентом
- переименовать файл и не потерять ссылки на него
- проверить, что попало в индекс и когда он обновлялся
Примеры запросов агенту
- Найди в хранилище всё, что я писал про индексацию, и покажи самые близкие по смыслу фрагменты
- Какие заметки связывают мои записи про MCP и про Obsidian? Построй путь между ними
- Создай заметку про план на неделю и свяжи её с
inbox.md
Как установить Obsidian Brain
Командой платформы
claude mcp add --env VAULT_PATH=<VAULT_PATH> --env DATA_DIR=<DATA_DIR> --env EMBEDDING_PRESET=<EMBEDDING_PRESET> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --env EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> --transport stdio obsidian-brain -- npx -y obsidian-brainВместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера
Командой платформы
codex mcp add obsidian-brain --env VAULT_PATH=<VAULT_PATH> --env DATA_DIR=<DATA_DIR> --env EMBEDDING_PRESET=<EMBEDDING_PRESET> --env EMBEDDING_MODEL=<EMBEDDING_MODEL> --env EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> -- npx -y obsidian-brainВместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"obsidian-brain": {
"command": "npx",
"args": [
"-y",
"obsidian-brain"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>",
"DATA_DIR": "<DATA_DIR>",
"EMBEDDING_PRESET": "<EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"obsidian-brain": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obsidian-brain"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>",
"DATA_DIR": "<DATA_DIR>",
"EMBEDDING_PRESET": "<EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e VAULT_PATH=<VAULT_PATH> -e DATA_DIR=<DATA_DIR> -e EMBEDDING_PRESET=<EMBEDDING_PRESET> -e EMBEDDING_MODEL=<EMBEDDING_MODEL> -e EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> obsidian-brain npx -y obsidian-brainВместо <…> подставьте свои значения. Ещё 14 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Obsidian Brain
Как установить Obsidian Brain в Claude Code?
Одной командой: claude mcp add obsidian-brain -e VAULT_PATH=<VAULT_PATH> -- npx -y obsidian-brain. Подставьте вместо <VAULT_PATH> абсолютный путь к хранилищу.
Что делает Obsidian Brain?
Даёт MCP-клиенту доступ к хранилищу Obsidian: поиск по фрагментам, обход графа связей, чтение и запись заметок. Obsidian при этом может быть закрыт.
Обязателен ли плагин внутри Obsidian?
Для базовых инструментов нет. active_note, dataview_query и base_query работают только с плагином-компаньоном, и его версия должна совпадать с версией сервера вплоть до мажорной и минорной.
