Obsidian Vault MCP — литература из Zotero
Obsidian Vault MCP
Локальный MCP-сервер для научной литературы: Zotero как источник, MinerU для полного текста, Obsidian для заметок, вики и анализа
- 95 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Сервер пишет и перезаписывает заметки, вики и файлы в хранилище Obsidian
- Разбор через MinerU может отправлять PDF во внешний сервис
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/obsidian-vault-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер пишет и перезаписывает заметки, вики и файлы в хранилище Obsidian
- Разбор через MinerU может отправлять PDF во внешний сервис
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Obsidian Vault MCP связывает три программы в процесс работы с литературой: Zotero хранит источники, MinerU превращает PDF в Markdown, а хранилище Obsidian накапливает заметки, вики и разборы. Ключом записи служит `zoteroKey` родительского элемента Zotero, поэтому у каждой работы стабильный идентификатор. Сервер дает 31 инструмент в группах: система и конфигурация, Zotero (поиск, коллекции, заметки, аннотации), импорт и синхронизация, MinerU, навигация и проверка, Analysis, вики и транзакции. Поддерживаются BibTeX, сохраненные и связанные вложения. Для каждой работы создаются основная заметка, PDF и полный текст с отдельной папкой изображений, а также индекс `Literature/index.md` и база `Literature.base`. Поверх инструментов идут 7 скиллов: `paper-qa`, `full-read`, `passage-qa`, `figure-qa`, `compare-papers`, `literature-review`, `concept-learning`. Пять типов анализа (`full_read`, `literature_review`, `passage_qa`, `figure_qa`, `concept`) сохраняются в хранилище. Любая запись идет через dry-run, затем транзакция с резервной копией и откатом. Установить сервер в клиент помогает команда `obsidian-vault-mcp agent install codex` (подходят также `claude`, `opencode`, `pi`, `hermes`, `workbuddy`).
Для кого. Исследователи и аспиранты, которые ведут библиотеку в Zotero и конспекты в Obsidian и хотят читать статьи с агентом по проверяемой схеме.
Подходит, если
- Нужно загрузить статью из Zotero в хранилище с полным текстом и картинками
- Надо получить ответ по конкретному абзацу или рисунку с указанием места в тексте
- Составляете обзор по набору работ и хотите сохранять результат как заметку анализа
- Нужно сопоставить несколько статей в матрицу сравнения
- Хочется видеть любые правки хранилища сначала как dry-run с откатом
Не подходит, если
- Нет Zotero Desktop с включенным локальным API: он служит источником
- Хранилище не открывалось в Obsidian: целевой каталог должен содержать `.obsidian/`
- Нужна простая заметка по одному файлу без библиотеки Zotero: сервер построен вокруг нее
Пример запроса к агенту
Импортируй статью ABCD1234 из Zotero, разбери PDF через MinerU и ответь, как авторы обосновывают метод, со ссылкой на абзац.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
OBSIDIAN_VAULT_PATHобязательная- Путь к хранилищу Obsidian, в котором есть папка `.obsidian`
Ограничения
Нужен Python 3.10 или новее, запущенный Zotero Desktop с локальным API и хранилище, уже открытое в Obsidian. Разбор PDF через MinerU может отправлять файлы во внешний сервис, поэтому сверьтесь с политикой организации и правами на документы. Автор рекомендует локальный `stdio`, а SSE и HTTP держать за доверенной авторизацией. Резервные копии транзакций не заменяют полноценный бэкап хранилища. README написан по-китайски, английская версия лежит в `README.en.md`. Установка закреплена на версии 3.0.2.
Как отключить. Удалите запись `obsidian-literature` из конфигурации MCP и снимите пакет командой `uv tool uninstall zotero-obsidian-mcp`. Заметки в хранилище остаются как обычные файлы Markdown.
Частые вопросы
Как установить Obsidian Vault MCP?
Командой `uv tool install "zotero-obsidian-mcp==3.0.2"`, затем `obsidian-vault-mcp config init --vault-path <путь>`. Альтернативы: `pipx`, `pip` и запись `io.github.luffysolution-svg/obsidian-vault-mcp` в реестре MCP.
С какими клиентами работает?
Codex, Claude Code, OpenCode, Pi, Hermes и WorkBuddy. Для Codex и Claude Code ставятся маркетплейс-плагин, MCP и 7 скиллов, для OpenCode MCP и скиллы, для Hermes и WorkBuddy только настройка MCP.
Что делает MinerU в этой связке?
Превращает PDF в Markdown, для каждой работы создается своя папка с изображениями и относительные ссылки. Файл появляется по пути вида `Literature/attachment/MinerU/ABCD1234.md`.
Безопасна ли запись в хранилище?
Любая запись сначала идет как dry-run, затем фиксируется транзакцией с `transactionId`, резервной копией, блокировкой, атомарной заменой и откатом. Это не заменяет отдельный бэкап хранилища.
Нужен ли Zotero?
Да, Zotero Desktop с включенным локальным API. Он служит источником и дает основной ключ записи `zoteroKey`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПлагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
Локальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
Локальный MCP-сервер позволяет агенту искать и читать вашу библиотеку Zotero, хранилище Obsidian и Apple Notes через ядро на C++
CLI и MCP-сервер для библиотеки научных статей: агент ищет, импортирует и читает статьи, ведет заметки Markdown в вашем хранилище
MCP-сервер для Zotero: поиск по словам и смыслу, цитаты из PDF со страницами, ссылки в CSL и добавление статей по DOI
MCP-сервер плагина seerai для Zotero дает агентам 46 инструментов: поиск по библиотеке и научным базам, обзоры, рабочая папка.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Obsidian Vault MCP — литература из Zotero (эта карточка) | нет | не нужна | 95 | |
| Zotero MCP | нет | ключ необязателен | 5 884 | доступ к Zotero без хранилища Obsidian и полного текста из MinerU |
| obsidian-second-brain | нет | 5 297 | общая память в Obsidian, не привязана к Zotero |
Коротко о README
README показывает архитектуру в виде схемы от задачи на естественном языке к скиллам, инструментам и связке Zotero, PDF, MinerU и Obsidian. Затем перечислены ключевые функции, установка через uv, pipx и реестр MCP, первичная настройка, установка в агентов, таблица скиллов, состав 31 инструмента и границы безопасности.