
smart-connections
gogogadgetbytesv0.2.0MIT
3 звёзд3 форков
Безопасный MCP-сервер для семантического поиска по хранилищу Obsidian. Он использует эмбеддинги, которые уже построены плагином Smart Connections, и работает локально — данные не покидают ваш компьютер. Сервер создан для интеграции с Claude Code и другими MCP-клиентами.
Стандартный текстовый поиск не всегда эффективен, если вы помните суть заметки, но не точные слова. Семантический поиск находит релевантные файлы по смыслу запроса. Разработчики ценят этот сервер за минималистичную архитектуру (только TypeScript и Transformers.js), строгую безопасность и полную изоляцию файловой системы. В основе — принцип read-only: никаких операций записи, только чтение и поиск.
- Сервер сообщества
- Локальный запуск (stdio)
- TypeScript
- Лицензия MIT
- Обновлён 4 февраля 2026 г.
Подключение
Подключить smart-connections
Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.
1
Способ подключения
2
Куда подключить
3
Скопируйте и проверьте
Claude Desktop / Claude Code
Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.
- 1.Откройте настройки MCP в Claude.
- 2.Добавьте сервер с указанной командой и переменными окружения.
- 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
"mcpServers": {
"smart-connections": {
"command": "npx",
"args": [
"-y",
"@gogogadgetbytes/smart-connections-mcp"
]
}
}
}Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.
Характеристики
Общее
- СтатусСообщество
- Разработчикgogogadgetbytes
- Версияv0.2.0
- ЛицензияMIT
- Последний релиз04.02.2026
- Активность источника04.02.2026
Технологии
- Языки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-клиенты




