Obsidian Vault MCP — MCP-сервер для Claude Code: как установить
Связывает Zotero, MinerU и базу Obsidian для работы с научными статьями. Помогает извлекать текст из PDF, вести структурированные выжимки и строить вики-заметки.
claude mcp add obsidian-vault-mcp -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -- uvx zotero-obsidian-mcpЧто делает Obsidian Vault MCP
Сервер объединяет десктопный Zotero, парсер MinerU и локальное хранилище Obsidian в единую систему для исследовательской работы. В пакет входят 31 инструмент MCP и 7 готовых исследовательских навыков. ИИ-агент находит статьи в Zotero по ключу zoteroKey, извлекает текст и иллюстрации из PDF с помощью MinerU, а затем раскладывает форматированный Markdown, каталоги и вики-заметки по папкам хранилища.
Для сохранения выводов предусмотрено пять форматов аналитических заметок, от детального разбора до ответов по конкретным графикам или уравнениям. Все операции записи выполняются безопасно: сервер поддерживает пробный запуск dry-run, блокировки файлов, промежуточное сохранение и откат изменений при сбоях.
Каталог Obsidian перед запуском должен быть инициализирован в самом приложении и содержать системную папку .obsidian/, иначе сервер не заработает. Для запуска требуются Python 3.10 или новее, а также запущенный Zotero Desktop с включённым локальным API.
Какие задачи решает
- Импортировать статьи и аннотации из локальной библиотеки Zotero
- Конвертировать научные PDF в Markdown через MinerU с сохранением иллюстраций
- Формировать структурированные аналитические заметки и вики по публикациям
- Сравнивать выбранные научные статьи по общим критериям
Примеры запросов агенту
- Найди в Zotero статью по фотокатализу и импортируй её в хранилище
- Сделай полный разбор статьи с ключом ABCD1234 и сохрани заметку в папку Analysis
- Сравни две выбранные публикации и выдели различия в их методологии
Как установить Obsidian Vault MCP
Командой платформы
claude mcp add obsidian-vault-mcp -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -- uvx zotero-obsidian-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zotero-obsidian-mcp <команда>
Командой платформы
codex mcp add obsidian-vault-mcp --env OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -- uvx zotero-obsidian-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zotero-obsidian-mcp <команда>
Файл настроек
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zotero-obsidian-mcp <команда>
Файл настроек
{
"servers": {
"obsidian-vault-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zotero-obsidian-mcp <команда>
Командой платформы
gemini mcp add -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> obsidian-vault-mcp uvx zotero-obsidian-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from zotero-obsidian-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Obsidian Vault MCP
Как установить Obsidian Vault MCP в Claude Code?
Выполните команду claude mcp add obsidian-vault-mcp -e OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH> -- uvx zotero-obsidian-mcp. Вместо <OBSIDIAN_VAULT_PATH> укажите путь к каталогу вашего хранилища Obsidian.
Что делает Obsidian Vault MCP?
Сервер связывает Zotero, парсер PDF MinerU и хранилище Obsidian. Он позволяет ИИ-агенту читать библиографию, форматировать статьи в Markdown и автоматически вести базу исследовательских заметок.
Что нужно подготовить перед запуском сервера?
Потребуются Python 3.10+, запущенный Zotero Desktop с включённым локальным API и каталог, уже открытый в Obsidian с созданной папкой .obsidian/. Готовность окружения проверяется утилитой obsidian-vault-mcp doctor.
