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; сеть только для загрузки модели.

Настройка клиентов

claude-code
{
    "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

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники