Smart Connections

Smart Connections

gogogadgetbytesMIT
2 звёзд2 форков
Безопасный MCP-сервер для семантического поиска по хранилищу Obsidian. Он использует эмбеддинги, которые уже построены плагином Smart Connections, и работает локально — данные не покидают ваш компьютер. Сервер создан для интеграции с Claude Code и другими MCP-клиентами. Стандартный текстовый поиск не всегда эффективен, если вы помните суть заметки, но не точные слова. Семантический поиск находит релевантные файлы по смыслу запроса. Разработчики ценят этот сервер за минималистичную архитектуру (только TypeScript и Transformers.js), строгую безопасность и полную изоляцию файловой системы. В основе — принцип read-only: никаких операций записи, только чтение и поиск.
Подключение

Подключить Smart Connections

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "smart-connections": {
      "command": "npx",
      "args": [
        "-y",
        "@gogogadgetbytes/smart-connections-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Smart Connections

Smart Connections относится к Поиск, Obsidian. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
TypeScript
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикgogogadgetbytes
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Семантический поиск по тексту: сервер находит заметки по смыслу, а не по точному совпадению слов.
  • Локальная обработка: эмбеддинги используются из вашего хранилища, отправка данных на сторонние серверы не требуется.
  • Текстовый поиск через Transformers.js — не нужны тяжёлые зависимости вроде PyTorch.
  • Поддержка офлайн-режима: Obsidian не должен быть запущен, интернет не нужен.
  • Валидация путей: строгая проверка через realpath, блокировка симлинков и последовательностей ../.
  • Ограничение ответов: не более 50 результатов и 10 КБ контента на запрос.
  • Изоляция файловой системы: сервер не выходит за пределы указанного хранилища.
  • Полный аудит безопасности: все события логируются с контекстом.
  • Read-only архитектура: нет операций записи или выполнения команд.

Как подключить

Установите Node.js версии 18 или выше. Убедитесь, что в Obsidian установлен плагин Smart Connections и эмбеддинги построены.

Выполните установку через пакетный менеджер:

npx -y @gogogadgetbytes/smart-connections-mcp

Добавьте конфигурацию в файл MCP-клиента (например, ~/.claude.json):

{ "mcpServers": { "smart-connections": { "command": "npx", "args": ["-y", "@gogogadgetbytes/smart-connections-mcp"], "env": { "VAULT_PATH": "/полный/путь/к/вашему/хранилищу/obsidian" } } } }

Перезапустите клиент (Claude Desktop, Claude Code или другой). Сервер готов к работе.

Примеры запросов

  • «Найди в моём хранилище заметки, связанные с Agile-методологиями».
  • «Покажи несколько файлов, наиболее близких по смыслу к заметке "План развития отдела"».
  • «Собери все упоминания стратегий бэкапа данных и подготовь краткую сводку».
  • «Проанализируй мои заметки за последний месяц и найди повторяющиеся темы».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Репозиторий: gogogadgetbytes/smart-connections-mcp
  • Основные зависимости: MCP SDK, Transformers.js
  • Требования: Node.js 18+, Obsidian + Smart Connections
  • Совместимость: Claude Desktop, Claude Code, любые MCP-клиенты

Поделиться