TurboVault MCP
MCP-сервер на Rust для хранилища Obsidian: поиск, граф ссылок, правка заметок с проверкой хеша и откатом по журналу.
- 158 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент создает, меняет, переносит и удаляет заметки в подключенном хранилище. Удаление и замена просят подтверждение, а изменения пишутся в журнал с откатом.
Установка
- Работает в
Ручная установка
cargo install turbovaultТолько stdio, этого хватает для Claude Desktop и Claude Code. Готовые бинарные файлы есть на странице релизов, также доступен образ Docker.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент создает, меняет, переносит и удаляет заметки в подключенном хранилище. Удаление и замена просят подтверждение, а изменения пишутся в журнал с откатом.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TurboVault — MCP-сервер, который дает агенту безопасный доступ к хранилищу Obsidian. Это один бинарный файл на Rust без внешних зависимостей. Агент читает и правит заметки, ищет по словам (BM25) и по смыслу (TF-IDF), строит граф связей и оценивает здоровье хранилища по шкале от 0 до 100. Запись идет единственным путем: атомарная замена файла с проверкой хеша либо один коммит Git на запись или пакет. При переносе заметки сервер переписывает вики-ссылки, ссылки Markdown и карточки Canvas. Каждое изменение попадает в журнал с цепочкой хешей, а `rollback_note` откатывает его по идентификатору операции. Перед поиском индекс сверяется с диском, поэтому правки из Obsidian, синхронизации или `git pull` видны сразу.
Для кого. Пользователям Obsidian с большим хранилищем, которые отдают агенту уход за заметками и хотят иметь откат любой правки.
Подходит, если
- Агент ищет ответ в личной базе знаний из тысяч заметок.
- Заметку переименовывают, и ссылки на нее обновляют по всему хранилищу.
- Хранилище лежит в Git, и каждая правка агента должна стать отдельным коммитом.
- Нужен отчет о здоровье хранилища: битые ссылки, тупики, дубликаты.
- Ежедневные и недельные заметки создаются по настройкам Periodic Notes.
Не подходит, если
- Заметки лежат в закрытой базе приложения и не сохранены файлами Markdown.
- Агенту нельзя ничего менять: тогда подойдет только запуск с `--profile read-only`.
- Нужен плагин внутри самого Obsidian: TurboVault работает с папкой на диске и в приложение не встраивается.
Пример запроса к агенту
Найди заметки про онбординг без входящих ссылок, предложи связи и перенеси одну из них в архив с обновлением ссылок.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Хранилище подключают при запуске флагом `--vault` или позже инструментом `add_vault`. Корень диска, домашний каталог и системные папки подключить нельзя. Скрытые папки `.obsidian`, `.git` и `.turbovault` недоступны инструментам заметок. Файлы больше 10 МиБ не читаются и не записываются. После запуска на 50 тысячах заметок сервер занимает около 0,93 ГБ памяти, на 10 тысячах — 213 МБ. SQL по frontmatter и векторный поиск включаются при сборке отдельными функциями `sql` и `vector-search`. Сетевые транспорты требуют аутентификации, а на Windows, Linux и macOS есть готовые архивы.
Как отключить. Выполните `claude mcp remove turbovault` и удалите бинарный файл командой `cargo uninstall turbovault`. Журнал аудита в папке `.turbovault/` останется в хранилище, при ненадобности удалите его вручную.
Частые вопросы
Как подключить TurboVault к Claude Code?
Поставьте `cargo install turbovault`, затем выполните `claude mcp add turbovault -- turbovault --vault ~/Documents/Vault`. Без `--vault` сервер стартует пустым, и агент регистрирует хранилище инструментом `add_vault`.
С какого вызова начать работу?
С `get_vault_context`: он возвращает список хранилищ, число заметок, оценку здоровья и инструменты, сгруппированные по задачам.
Можно ли запретить агенту писать в хранилище?
Да. Запуск с `--profile read-only` отклоняет все изменяющие инструменты, а настройка `allowed_operations: read` закрывает на запись одно хранилище.
Как откатить неудачную правку?
Найдите операцию в `audit_log` и вызовите `rollback_note` с ее идентификатором. `rollback_preview` заранее покажет, что изменится. Если заметку после правки меняли снова, откат не перезапишет ее без явного разрешения.
Спрашивает ли сервер подтверждение перед удалением?
Да, если клиент умеет запрашивать подтверждение. Это касается `delete_note`, переноса с заменой, принудительного отката и добавления хранилища. Запрос отключается флагом `--no-confirm-destructive`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Плагин Obsidian со встроенным MCP: агент читает, ищет и правит файлы на облачных дисках, заметки синхронизируются.
Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
MCP-сервер к локальному архиву чатов ChatGPT, Claude, Gemini, Grok и Kimi в Markdown: агент ищет и читает прошлые разговоры.
Obsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| TurboVault (эта карточка) | нет | не нужна | 158 | |
| Obsidian MCP Server | нет | API-ключ | 702 | читает, ищет и точечно правит заметки; TurboVault добавляет граф связей, перенос с обновлением ссылок и откат по журналу |
| mcp-obsidian | нет | API-ключ | 4 520 | работает через плагин Local REST API внутри Obsidian; TurboVault читает папку хранилища напрямую одним бинарным файлом |
Коротко о README
В репозитории лежат сервер и набор крейтов Rust для разбора Obsidian Flavored Markdown, например `turbovault-core`. Разбор охватывает вики-ссылки, вложения, теги, задачи, блоки-выноски, frontmatter, JSON Canvas 1.0 и Bases.