Obsidian Sync MCP — хранилище Obsidian для агента
Obsidian Sync MCP
MCP-сервер дает агенту читать и править заметки Obsidian из папки или через Self-hosted LiveSync, даже когда ноутбук выключен
- 72 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент читает, перезаписывает, переносит и удаляет заметки хранилища
- Облачное развертывание открывает хранилище по сети, а пароль CouchDB и `MCP_AUTH_TOKEN` защищают все содержимое
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/obsidian-sync-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает, перезаписывает, переносит и удаляет заметки хранилища
- Облачное развертывание открывает хранилище по сети, а пароль CouchDB и `MCP_AUTH_TOKEN` защищают все содержимое
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Obsidian Sync MCP открывает любому MCP-агенту ваше хранилище Obsidian по HTTP. Есть два режима: файловый (читает файлы `.md` из папки хранилища, база не нужна) и CouchDB (читает базу, в которую хранилище синхронизируется плагином Self-hosted LiveSync, с поддержкой сквозного шифрования). Инструменты работают с заметками и вложениями: `read_note`, `write_note`, `edit_note` (дописать, вставить после frontmatter или заменить точный текст), `list_notes`, `search_notes`, `move_note`, `delete_note`, `list_tags`, `list_folders` и `get_note_metadata` со ссылками и обратными ссылками. Для вложений есть `create_attachment_upload`, `list_attachments` и другие. Каждый ответ содержит глубокую ссылку `obsidian://open`, которая открывает заметку на Mac и iOS. Сервер развертывают на облаке Fly.io скриптом `deploy/setup.sh` или Docker-образом, чтобы он отвечал и при выключенном компьютере. Доступ защищает `MCP_AUTH_TOKEN`, а вход агентов идет через OAuth.
Для кого. Тем, кто ведет заметки в Obsidian и хочет с телефона спрашивать агента о дневнике и проектах, пока ноутбук выключен.
Подходит, если
- С телефона хочется спросить, что в сегодняшней дневной заметке, и получить ссылку для открытия в Obsidian
- Заметки синхронизируются через LiveSync, и агенту нужен доступ без включенного компьютера
- Пункт добавляется в заметку встречи через `edit_note`, без переписывания всей заметки
- Все заметки с тегом проекта за последний месяц собираются одним запросом
Не подходит, если
- Нужен готовый облачный сервис без своего сервера: облачное развертывание делается самостоятельно
- Хранилище лежит без LiveSync, и компьютер выключается: файловый режим без него не работает
- Заметки содержат данные, которые нельзя отдавать агенту на правку и удаление
Пример запроса к агенту
Что в моей дневной заметке на сегодня? Дай ссылку для открытия в Obsidian и допиши задачу «позвонить в банк».MCP
- Транспорт
- http
- Авторизация
- ключ необязателен
Переменные окружения
VAULT_PATH- Путь к папке хранилища для файлового режима
COUCHDB_URL- Адрес CouchDB для режима LiveSync
COUCHDB_PASSWORDсекрет- Пароль CouchDB, обязателен в режиме CouchDB
MCP_AUTH_TOKENсекрет- Пароль, который вводит агент при подключении
Ограничения
Нужен Node.js 22 или новее либо Docker. Режим CouchDB требует настроенного плагина Self-hosted LiveSync и переменных `COUCHDB_URL`, `COUCHDB_USER`, `COUCHDB_PASSWORD`, `COUCHDB_DATABASE`. Для шифрованного хранилища добавляют `COUCHDB_PASSPHRASE`, для путей с обфускацией в LiveSync версии 1.0.33 и новее добавляют `COUCHDB_ID_DERIVATION_KEY`. Базу сервер сам не создает.
Облачное развертывание стоит около 3–4 долларов в месяц за CouchDB и MCP на Fly.io и около 0–2 долларов за один MCP. Токен `MCP_AUTH_TOKEN` служит паролем при подключении агента. Файловый режим работает, пока включена машина с хранилищем.
Как отключить. Остановите процесс или контейнер сервера и удалите коннектор из клиента. Для облака выполните `fly apps destroy` по своему приложению и смените пароль CouchDB.
Частые вопросы
Как запустить Obsidian Sync MCP без LiveSync?
В файловом режиме: `VAULT_PATH=~/Documents/MyVault VAULT_NAME=MyVault npx obsidian-sync-mcp`. Сервер читает файлы `.md` из папки хранилища.
Что дает режим CouchDB?
Доступ к заметкам, пока компьютер выключен: хранилище синхронизируется в CouchDB через Self-hosted LiveSync, а сервер читает базу напрямую.
Как защищено подключение?
Токеном `MCP_AUTH_TOKEN` и входом агентов через OAuth; без токена сервер принимает только заданные хосты, защищаясь от DNS-rebinding.
Можно ли дописать заметку, не переписывая ее?
Да, `edit_note` дописывает в конец, вставляет после frontmatter или заменяет точный фрагмент текста.
Сколько стоит облачное развертывание?
По данным README, около 3–4 долларов в месяц за CouchDB с MCP на Fly.io и около 0–2 долларов за один MCP.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыObsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Obsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
Плагин Obsidian со встроенным MCP: агент читает, ищет и правит файлы на облачных дисках, заметки синхронизируются.
Obsidian MCP Plugin
obsidian-mcp-plugin
Плагин Obsidian: сервер MCP работает внутри Obsidian, восемь инструментов для хранилища, поиска и графа. Установка через каталог плагинов или .mcpb
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Obsidian Sync MCP — хранилище Obsidian для агента (эта карточка) | нет | ключ необязателен | 72 | |
| mcp-obsidian | нет | API-ключ | 4 532 | другой MCP-сервер для Obsidian; здесь добавлены режим LiveSync и облачное развертывание |
| Obsidian Hybrid Search | нет | не нужна | 123 | добавляет гибридный поиск по хранилищу; здесь доступ к заметкам и вложениям с правкой |
Коротко о README
README ведет по трем сценариям установки: MCP в облако рядом с CouchDB, все в облако с нуля и запуск на своей машине. Дальше идут таблицы инструментов для заметок и вложений, переменные окружения и расчет стоимости на Fly.io.