smart-connections-mcp — MCP-сервер для Claude Code: семантический
Ищет заметки в хранилище Obsidian по смыслу, а не по словам. Пригодится, когда агенту нужно вспомнить, что вы уже писали по теме.
claude mcp add smart-connections-mcp -e SMART_VAULT_PATH=<SMART_VAULT_PATH> -- npx -y smart-connections-mcpЧто делает smart-connections-mcp
Сервер подключается к хранилищу Obsidian и переиспользует векторы, которые уже посчитал плагин Smart Connections. Запросы он обрабатывает той же моделью эмбеддингов, что и само хранилище, поэтому поиск идёт по смыслу. Всё считается на вашей машине, наружу ничего не уходит.
Инструменты: search_notes ищет по заметкам и отдельным блокам, get_similar_notes находит похожие заметки по сохранённым векторам, get_connection_graph разворачивает связи между идеями, get_note_content читает заметку или её фрагменты, а list_vaults и get_stats показывают, что загружено и какие модели использованы. Хранилищ можно подключить несколько — пути перечисляются через запятую в SMART_VAULT_PATH.
Нужен Node.js 20 или новее и хранилище с установленным плагином Smart Connections, где эмбеддинги уже сгенерированы. Если модель не загрузилась или у хранилища ещё нет векторов, поиск переключается на обычное совпадение по словам и честно об этом сообщает в ответе. Правки в Obsidian подхватываются сами.
Какие задачи решает
- найти заметки по смыслу, а не по точному слову
- прочитать нужный блок заметки, не открывая весь файл
- связать близкие идеи из разных хранилищ
- проверить, какие хранилища и модели загружены
- получить похожие заметки по уже сохранённым векторам
Примеры запросов агенту
- Найди в моём хранилище заметки про планирование релизов
- Покажи заметки, похожие на
weekly-review.md - Прочитай блок про бюджеты из заметки про квартал
Как установить smart-connections-mcp
Командой платформы
claude mcp add smart-connections-mcp -e SMART_VAULT_PATH=<SMART_VAULT_PATH> -- npx -y smart-connections-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add smart-connections-mcp --env SMART_VAULT_PATH=<SMART_VAULT_PATH> -- npx -y smart-connections-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"smart-connections-mcp": {
"command": "npx",
"args": [
"-y",
"smart-connections-mcp"
],
"env": {
"SMART_VAULT_PATH": "<SMART_VAULT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"smart-connections-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"smart-connections-mcp"
],
"env": {
"SMART_VAULT_PATH": "<SMART_VAULT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SMART_VAULT_PATH=<SMART_VAULT_PATH> smart-connections-mcp npx -y smart-connections-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о smart-connections-mcp
Как установить smart-connections-mcp в Claude Code?
Одной командой: claude mcp add smart-connections-mcp -e SMART_VAULT_PATH=<SMART_VAULT_PATH> -- npx -y smart-connections-mcp. Вместо <SMART_VAULT_PATH> подставьте путь к хранилищу.
Что делает smart-connections-mcp?
Даёт агенту семантический поиск по хранилищу Obsidian: находит заметки и блоки по смыслу, показывает похожие заметки и связи между ними. Векторы берутся из плагина Smart Connections, обработка идёт локально.
Что нужно для работы сервера?
Node.js версии 20 или выше и хранилище Obsidian с плагином Smart Connections, где эмбеддинги уже сгенерированы. Без готовых векторов поиск работает по словам.
