Obsidian Semantic Search

Obsidian Semantic Search

DalecBMIT
Obsidian Semantic Search — read-only MCP-сервер для поиска заметок в Obsidian по смыслу. Он использует локальные эмбеддинги через Ollama. AI-агент находит нужную запись, даже если формулировки запроса не совпадают с текстом заметки. Обычный поиск по ключевым словам не справляется с контекстом — этот сервер решает проблему. Сервер читает Markdown-файлы прямо из файловой системы. Obsidian может быть закрыт. В сервере нет инструментов для записи, перемещения или удаления заметок. Индекс строится локально в SQLite. Никаких облачных эмбеддингов, никаких внешних сервисов синхронизации. Подходит для агентов, которым нужен доступ к знаниям, но не к управлению заметками.
SearchObsidian
Открыть на GitHub

Установка

npx -y @dalecb/obsidian-semantic-mcp

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

Общее

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

Технологии

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

Описание

Возможности

  • Ищет гибридным методом: семантический поиск плюс поиск по ключевым словам
  • Работает только на чтение: search, read, index, status — без write, delete, move, rename
  • Хранит индекс локально: Ollama для эмбеддингов, SQLite для базы
  • Читает файлы напрямую: не требует запущенного Obsidian
  • Отдаёт структурированный ответ: путь, заголовки, сниппеты, номера строк
  • Показывает прозрачную оценку релевантности: агент видит вклад семантики, ключевых слов и метаданных
  • Индексирует хранилище при запуске и по запросу
  • Опирается на модель эмбеддингов bge‑m3 от Ollama

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

Перед установкой убедитесь, что на вашей машине установлены Node.js версии 24 или новее, запущен Ollama и есть хранилище Obsidian.

  1. Установите модель для эмбеддингов: ollama pull bge-m3
  2. Запустите скрипт первоначальной настройки. Он задаст путь к хранилищу: npx -y --package @dalecb/obsidian-semantic-mcp obsidian-semantic-mcp-setup
  3. Добавьте сервер в конфигурацию MCP-клиента. Пример для Claude Desktop: { "mcpServers": { "obsidian-semantic-search": { "command": "npx", "args": ["-y", "@dalecb/obsidian-semantic-mcp"] } } }
  4. Перезапустите клиент. Сервер просканирует хранилище и будет готов к работе.

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

  • «Найди в моих заметках всё, что относится к архитектуре event-driven систем.»
  • «Покажи конспекты и мысли по книге Designing Data-Intensive Applications.»
  • «Поищи в хранилище записи о паттернах CQRS и Event Sourcing.»
  • «Найди старые наброски идей для pet-проектов — по смыслу, а не по заголовкам.»

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

  • Язык: JavaScript (Node.js)
  • Транспорт: stdio
  • Лицензия: MIT
  • Модель эмбеддингов: bge‑m3 (Ollama)
  • Хранилище индекса: SQLite
  • Совместимость: Claude Desktop, Codex, Cursor, Continue.dev, Zed — любые MCP-клиенты с stdio

Поделиться