smart-connections

smart-connections

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

Установка

npx -y @gogogadgetbytes/smart-connections-mcp

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

Общее

  • СтатусСообщество
  • Разработчик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-клиенты

Поделиться