Об этом проекте

Vault Cortex — это автономный сервер MCP (Model Context Protocol), который предоставляет ИИ-агентам гибридный поиск, управление задачами, структурированную память и доступ на чтение/запись к хранилищам Obsidian. Он работает напрямую с `.md`-файлами на диске, не требуя плагинов Obsidian или запущенного экземпляра. Сервер выполняется в одном контейнере Docker и может быть развёрнут локально, на собственном VPS или одним нажатием на Railway или Render для удалённого доступа. **Ключевые возможности:** - **Гибридный поиск**: объединяет сопоставление ключевых слов FTS5 с векторной семантической схожестью через Reciprocal Rank Fusion (RRF), дополняя перекрёстным энкодерным реранжированием для запросов с ярко выраженным намерением. Все модели работают локально (~45 МБ суммарно, без внешних API). - **Структурированная память**: система добавляемых датированных записей, хранящихся в обычных Markdown-файлах (по умолчанию папка `About Me/`). Припоминание по теме извлекает релевантные записи из всех файлов памяти, показывая текущее состояние и историческое развитие. Поддерживает `entry-policy: living` для записей о текущем состоянии, которые можно очищать. - **Управление задачами**: запросы и обновления задач с учётом канбан. Поддерживает фильтрацию по статусу, датам, приоритету, папке или дорожке (lane). Работает как с эмодзи-маркерами плагина Tasks, так и со встроенными полями Dataview. Завершение повторяющихся задач создаёт следующие вхождения; поддерживаются действия «On completion». - **Доступ к файлам**: читает файлы не-Markdown, включая изображения (уменьшаются на стороне сервера), PDF (извлечение текста или отрисовка страниц), холсты (читаемые структуры) и файлы данных (TXT, SVG, JSON, XML, CSV, YAML, журналы, Bases). - **Граф ссылок**: обратные ссылки, исходящие ссылки и обнаружение осиротевших заметок по всему хранилищу. - **Нативность для Obsidian**: понимает frontmatter, вики-ссылки, теги, заголовки и ежедневные заметки. - **Управляемые сценарии**: встроенные подсказки для проверки состояния хранилища, обзора памяти и ежедневной сверки, собираемые из актуальных данных хранилища. **Аутентификация**: поддерживает OAuth 2.1 для удалённого доступа со страницами согласия, а также Bearer-токены для клиентов без OAuth. Продление токена для OAuth-клиентов выполняется автоматически. **Варианты развёртывания**: - Локально: Docker + папка хранилища, установка через `npx vault-cortex@latest init` - Удалённо: развёртывание в один клик на Railway или Render либо самостоятельное размещение на любом Linux VPS с Docker - При удалённых развёртываниях Obsidian Sync используется для актуализации хранилища на разных устройствах **Установка**: CLI управляет жизненным циклом сервера (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`). Также доступна ручная установка через Docker Compose. Страница установки `/setup` обрабатывает вход в Obsidian Sync для удалённых развёртываний. **Безопасность**: включает CI со сканированиями Gitleaks и Trivy, бейджи OpenSSF Scorecard и Best Practices. Хранилище остаётся источником истины в обычном Markdown; контейнер хранит только копию. **Сценарии использования**: проверено в 15-дневной поездке по Европе с более чем 30 сессиями с телефона, 216 вызовами инструментов и нулевым доступом к ноутбуку. Записи, сделанные в одной сессии, немедленно были доступны в следующей между городами и днями.