vault-cortex

vault-cortex

aliasunderMIT
1 звёзд
vault-cortex — это MCP-сервер, который даёт AI-ассистентам прямой доступ к вашему хранилищу Obsidian. Вам больше не нужен запущенный Obsidian, плагин Local REST API и связка из трёх сервисов. Всё работает через один Docker-контейнер. Сервер читает файлы .md прямо с диска. Он понимает фронтматер, викиссылки, теги и заголовки — весь синтаксис Obsidian. Для поиска используется SQLite FTS5 с ранжированием BM25, стеммингом и поиском по фразам. Есть фильтрация по тегам, свойствам и папкам. Для удалённого доступа сервер поддерживает OAuth 2.1. Вы можете подключиться к своему хранилищу с телефона, удалённого сервера или любого MCP-клиента. Внутри 23 инструмента: от поиска и работы с заметками до управления графом связей и структурированной памятью. Результаты поиска ранжируются — самые релевантные заметки всегда сверху.
SearchObsidian
Открыть на GitHubОфициальный сайт

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

Общее

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

Технологии

  • Языки
    TypeScript
  • Транспорт
    streamable-http

Описание

Возможности

  • Поиск с ранжированием: SQLite FTS5, стемминг, BM25, поиск по фразам
  • Фильтрация результатов по тегам, свойствам (frontmatter properties) и папкам
  • Чтение и запись содержимого заметок с поддержкой Obsidian-синтаксиса
  • Разрешение daily notes (ежедневных заметок)
  • Запрос графа связей: поиск связанных заметок, путей, изолированных узлов
  • Управление структурированной памятью: датированные записи, привязка к разделам, автоинициализация для AI-персонализации
  • Работа с заметками без запущенного Obsidian (plugin-free, headless sync)
  • Удалённый доступ через OAuth 2.1
  • Развёртывание в Docker: один образ без ручной установки зависимостей
  • Поддержка всех MCP-клиентов: Claude Desktop, Claude Code, Cursor, OpenCode и другие

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

1. Запустите сервер через Docker:

docker run -d -v /путь/к/вашему/хранилищу:/vault -p 3040:3040 --name vault-cortex aliasunder/vault-cortex

2. Добавьте сервер в конфигурацию Claude Desktop:

{ "mcpServers": { "vault-cortex": { "type": "streamable-http", "url": "http://localhost:3040/mcp" } } }

3. Перезапустите Claude Desktop, чтобы он подхватил новый инструмент.

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

  • «Найди все заметки по проекту "Квант", отсортируй по дате изменения и покажи три последние»
  • «Найди в графе связей заметку, которая ссылается на "Архитектура" и "База данных"»
  • «Запомни, что мой любимый цвет — синий, и сохрани это в структурированную память с датой»

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

  • Язык: TypeScript
  • Транспорт: streamable-http
  • Лицензия: MIT
  • Совместимые клиенты: Claude Desktop, Claude Code, Cursor, OpenCode и любые другие MCP-клиенты
  • Зависимости: Node.js 24 или Docker

Поделиться