smart-connections-mcp
smart-connections-mcp — MCP-сервер сообщества (автор — msdanyg). Локальный семантический поиск по Obsidian через Smart Connections. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- msdanyg
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Читает заметки и эмбеддинги хранилищ Obsidian; сеть только для загрузки модели.
Настройка клиентов
{
"code": "claude mcp add smart-connections -e SMART_VAULT_PATH=\"/path/to/vault\" -- npx -y smart-connections-mcp",
"lang": "sh",
"verified": "docs"
}
Что умеет
Smart Connections MCP Server даёт Claude настоящую семантическую память о хранилище Obsidian. Сервер ищет заметки по смыслу, повторно используя эмбеддинги, которые уже создал плагин Smart Connections для Obsidian, и локально запускает ту же модель эмбеддингов, чтобы понимать запросы. Облачных вызовов нет: хранилище не покидает вашу машину.
Инструменты:
search_notes— семантический поиск по одному или нескольким хранилищам. Находит и целые заметки, и отдельные разделы (блоки), возвращает результаты по убыванию сходства с фрагментами текста.get_similar_notes— заметки, похожие на заданную (по сохранённым эмбеддингам).get_connection_graph— обход связей по сходству наружу, чтобы построить карту связанных идей.get_note_content— чтение заметки или отдельных блоков.list_vaultsиget_stats— что загружено, сколько записей, какие модели и ошибки загрузки.
Как это работает. Smart Connections хранит вектор эмбеддинга для каждой заметки и блока в папке .smart-env. Сервер загружает эти векторы в память, а при поиске кодирует запрос той же моделью, что использовало хранилище: она скачивается один раз (около 25 МБ) и работает локально через transformers.js. Результаты ранжируются по косинусному сходству. Правки в Obsidian подхватываются автоматически.
Запасной режим. Если модель не загрузилась (например, нет сети при первом запуске) или у хранилища ещё нет эмбеддингов, поиск переходит на буквальное совпадение слов и прямо сообщает об этом: режим keyword-fallback и предупреждение с причиной. Если на запасной режим перешли только некоторые хранилища, их строки помечаются как совпадения по словам и всегда идут после семантических.
Переход с версии 1. Инструмент get_embedding_neighbors удалён; search_notes стал по-настоящему семантическим и возвращает поля хранилища, области, блока, фрагмента и режима. Остальное обратно совместимо, конфиги с одним хранилищем работают без изменений.
Кому подойдёт
Пользователям Obsidian с плагином Smart Connections, которые хотят, чтобы агент находил связанные заметки по смыслу, а не по точным словам. Похожие серверы — в категории знания и память.
Установка
Нужны Node.js 20+ и хранилище Obsidian с установленным плагином Smart Connections и созданными эмбеддингами (вторая версия проверена на данных Smart Connections 3.x). Сервер запускается через npx -y smart-connections-mcp. Путь к хранилищу задаётся переменной SMART_VAULT_PATH; несколько хранилищ перечисляются через запятую. Принимается и вариант SMART_VAULT_PATHS, он имеет приоритет.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"smart-connections": {
"command": "npx",
"args": ["-y", "smart-connections-mcp"],
"env": {
"SMART_VAULT_PATH": "/path/to/Vault One,/path/to/Vault Two"
}
}
}
}Блок для Claude Desktop добавляют в claude_desktop_config.json, после чего приложение перезапускают.
Проверка
Спросите: «Какие хранилища загружены?» — агент вызовет list_vaults.
Примеры задач
Найди мои заметки о методах планирования, даже если там нет этих слов.Построй карту идей, связанных с заметкой «Исследование рынка».Риски
- Чтение заметок во всех указанных хранилищах.
- Сеть — только однократная загрузка модели; запись в хранилище сервер не выполняет.
Частые вопросы
Уходят ли заметки в облако?
Нет, всё работает локально.
Нужен ли плагин Smart Connections?
Да, сервер использует его эмбеддинги.
Можно ли подключить несколько хранилищ?
Да, через запятую.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.