MCPVault
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
- 1 721 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает и изменяет файлы заметок в указанной папке
- Может удалять и перемещать заметки, хотя это требует подтверждающего пути
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcpvaultОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает и изменяет файлы заметок в указанной папке
- Может удалять и перемещать заметки, хотя это требует подтверждающего пути
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCPVault запускается как локальный процесс по stdio и дает MCP-клиенту доступ к папке заметок Obsidian. Он предоставляет восемнадцать инструментов: чтение, запись, правку, удаление и перемещение заметок и файлов, частичное чтение и структуру заметки, работу с каталогами и пакетное чтение, поиск с многословным совпадением и переранжированием BM25, работу с frontmatter и тегами и разрешение wiki-ссылок. Правки frontmatter учитывают формат и сохраняют оформление неизменных полей YAML. Операции ограничены корнем хранилища: сервер блокирует выход за пределы папки, символьные ссылки, dotfiles и служебные каталоги вроде .obsidian, .git и node_modules. Удаление и перемещение требуют совпадающего пути подтверждения. Obsidian при этом запускать не нужно, плагин к нему не требуется.
Для кого. Для тех, кто ведет базу знаний в Obsidian и хочет читать и править заметки через ИИ-ассистента с ограничением доступа.
Подходит, если
- Нужно, чтобы ассистент искал и читал заметки в хранилище Obsidian
- Нужно создавать и править заметки с сохранением frontmatter
- Нужен доступ к заметкам без запуска Obsidian и без его плагинов
Не подходит, если
- У вас нет локальной папки заметок в формате Obsidian
- Нужна работа с заметками в облаке, а не с локальными файлами
Пример запроса к агенту
Найди в моем хранилище заметки про планы на квартал и собери из них короткое резюмеMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер работает с локальными файлами и требует Node.js 20 или новее. Доступ жестко ограничен указанным корнем хранилища. Удаление и перемещение выполняются только при совпадающем пути подтверждения. Сетевых интеграций у самого сервера нет, поэтому доступность зависит только от клиента.
Как отключить. Удалите запись obsidian из конфигурации MCP вашего клиента и перезапустите его.
Частые вопросы
Нужен ли запущенный Obsidian или его плагин?
Нет. MCPVault работает напрямую с файлами хранилища, Obsidian запускать не нужно.
Может ли сервер выйти за пределы папки заметок?
Нет. Операции ограничены корнем хранилища, выход по путям, символьным ссылкам и в служебные каталоги заблокирован.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Obsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
MCP-сервер на Rust для хранилища Obsidian: поиск, граф ссылок, правка заметок с проверкой хеша и откатом по журналу.
Плагин Obsidian со встроенным MCP: агент читает, ищет и правит файлы на облачных дисках, заметки синхронизируются.
Local REST API для Obsidian
Local REST API for Obsidian
Плагин Obsidian с защищенным REST API и встроенным MCP-сервером: агент читает, ищет и точечно правит заметки хранилища прямо из Claude Code или Cursor
Коротко о README
README описывает MCPVault как локальный MCP-сервер, который дает совместимым клиентам читать, искать и править заметки в хранилище Obsidian, ограничивая операции корнем хранилища. Клиент запускает сервер как локальный процесс по stdio и передает путь к папке, одни и те же инструменты доступны всем поддерживаемым клиентам. Есть примеры конфигурации для Claude Desktop, Claude Code, ChatGPT Desktop, OpenCode, Gemini CLI, Codex, IntelliJ IDEA, Cursor, Windsurf и Ontheia. Восемнадцать инструментов покрывают операции с файлами, частичное чтение, поиск с переранжированием BM25, frontmatter, теги и wiki-ссылки, удаление и перемещение требуют подтверждающего пути. Пакет публикуется в npm, лицензия MIT.