hebbian-vault

hebbian-vault

onetrueclaude-creatorMIT
hebbian-vault — MCP-сервер для поиска по хранилищу Obsidian, который подстраивается под то, как вы на самом деле работаете с заметками. В отличие от встроенного поиска Obsidian, сервер учитывает не только ключевые слова, но и частоту обращения к файлам, а также структуру связей между заметками. Для этого он объединяет три подхода: BM25 (классический полнотекстовый поиск), персонализированный PageRank (графовая центральность) и эвристику Хебба — файлы, к которым вы возвращаетесь чаще, получают больший вес. Результаты смешиваются через алгоритм Reciprocal Rank Fusion, что исключает ручную настройку весов. Сервер работает полностью локально, напрямую читает файлы вашего хранилища. Облако не нужно, Obsidian может быть закрыт. Подойдёт для личных заметок, рабочих баз знаний и любых других хранилищ.
SearchObsidian
Открыть на GitHub

Установка

uvx hebbian-vault

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

Общее

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

Технологии

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

Описание

Возможности

  • Указать путь к хранилищу во время работы, если он не был задан при запуске (инструмент configure_vault).
  • Выполнить гибридный поиск по хранилищу с учётом текстовой релевантности, популярности страниц и их связности (vault_search).
  • Прочитать полное содержимое заметки: основной текст, метаданные frontmatter и статистику использования (vault_read).
  • Найти связанные заметки по внутренним вики-ссылкам на один или два шага (vault_neighbors).
  • Получить список самых используемых файлов по эвристике Хебба с учётом давности (vault_hot).
  • Посмотреть аналитику хранилища: количество файлов, ссылок, изолированных заметок и страниц-хабов (vault_stats).
  • Проверить структурную целостность: найти битые ссылки и осиротевшие заметки (vault_health).
  • Хранить данные об использовании в отдельной папке .hebbian/ — ваши markdown-файлы не изменяются. По желанию можно записывать метрики прямо в YAML-шапку (флаг --inline-tracking).

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

  1. Установите пакет. Через pip: pip install hebbian-vault. Или запускайте через uvx: uvx hebbian-vault.
  2. Добавьте сервер в конфигурацию вашего MCP-клиента. Для Claude Desktop отредактируйте claude_desktop_config.json:
{ "mcpServers": { "hebbian-vault": { "command": "uvx", "args": ["hebbian-vault", "--vault", "/путь/к/вашему/хранилищу"] } } }

Вместо uvx можно указать команду hebbian-vault, если пакет установлен глобально.

Перезапустите клиент, чтобы сервер начал работу.

Если путь к хранилищу не указан при запуске, его можно задать позже через инструмент configure_vault.

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

  • «Найди в хранилище заметки по тегу "MCP" и отсортируй по релевантности, учитывая мои предпочтения».
  • «Покажи топ-10 файлов, к которым я обращался чаще всего за последний месяц».
  • «Проверь целостность хранилища: найди битые вики-ссылки и заметки, на которые никто не ссылается».
  • «Найди все заметки, связанные с проектом "Альфа", через один шаг вики-ссылок».
  • «Выдай аналитику хранилища: сколько всего заметок, ссылок, страниц-хабов и изолированных файлов».

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

  • Язык: Python
  • Транспорт: stdio (стандартный ввод-вывод)
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Claude Code, любые MCP-клиенты
  • Зависимости: не требует установленного Obsidian, работает напрямую с файловой системой

Поделиться