Smart Connections MCP Server

Дайте Клоду настоящую семантическую память о вашем хранилище Obsidian. MCP-сервер, который ищет ваши заметки по смыслу — используя эмбеддинги, которые Smart Connections плагин Obsidian уже создал, и запуская ту же модель эмбеддингов локально чтобы понимать ваши запросы. Никаких облачных вызовов; ваше хранилище никогда не покидает ваш компьютер.

Что это делает

• search_notes — семантический поиск по одному или нескольким хранилищам. Сопоставляет целые заметки и отдельные разделы (блоки), возвращает результаты, отсортированные по сходству, с фрагментами содержимого.

• get_similar_notes — заметки, похожие на данную заметку (сохранённые эмбеддинги).

• get_connection_graph — проходите по ссылкам сходства наружу, чтобы составить карту связанных идей.

• get_note_content — прочитать заметку или извлечь конкретные блоки.

• list_vaults / get_stats — что загружено, количество, модели, ошибки загрузки.

Related MCP server: ob-smart-connections-mcp

Требования

• Node.js 20+

• Хранилище Obsidian с установленным плагином Smart Connections и сгенерированными эмбеддингами (v2 протестировано с данными Smart Connections 3.x)

• MCP-клиент (Claude Desktop, Claude Code, …)

Настройка (Claude Desktop)

Добавьте в claude_desktop_config.json и перезапустите Claude Desktop:

{
  "mcpServers": {
    "smart-connections": {
      "command": "npx",
      "args": ["-y", "smart-connections-mcp"],
      "env": {
        "SMART_VAULT_PATH": "/path/to/Vault One,/path/to/Vault Two"
      }
    }
  }
}

Одно хранилище или несколько — разделяйте пути запятыми.

SMART_VAULT_PATHS (множественное число) также принимается как псевдоним для SMART_VAULT_PATH и имеет приоритет над ним, если заданы оба.

Claude Code

claude mcp add smart-connections -e SMART_VAULT_PATH="/path/to/vault" -- npx -y smart-connections-mcp

Как это работает

Smart Connections хранит вектор эмбеддинга для каждой заметки и блока в .smart-env/. Этот сервер загружает эти векторы в память и, когда вы ищете, встраивает ваш запрос с помощью той же модели, которую использовало ваше хранилище (загружается один раз, ~25 МБ, работает локально через transformers.js). Результаты ранжируются по косинусному сходству. Изменения, которые вы вносите в Obsidian, подхватываются автоматически.

Если модель эмбеддингов не может загрузиться (например, нет сети при самом первом запуске) или в хранилище ещё нет эмбеддингов, поиск переходит к буквальному сопоставлению по ключевым словам и явно сообщает об этом ("mode": "keyword-fallback" плюс warning с указанием причины). Когда только некоторые хранилища переходят в запасной режим, mode остаётся "semantic", эти строки несут "match": "keyword" и всегда ранжируются после настоящих семантических строк.

Переход с v1

• get_embedding_neighbors был удалён.

• search_notes теперь действительно семантический, и его ответ включает поля vault, scope, block, snippet и mode.

• Всё остальное обратно совместимо; конфигурации с одним хранилищем SMART_VAULT_PATH работают без изменений.

Разработка

npm install
npm test              # build + CI-tier tests (no network)
npm run test:live     # + real-model tests (downloads ~25MB once)
npm run smoke -- "/path/to/vault" "your query"

MIT — см. LICENSE.