Hive Vault — MCP-сервер для Claude Code: доступ к Obsidian-хранилищу
Подключает ИИ-ассистента к хранилищу Obsidian и выдаёт заметки по запросу, а не грузит всё сразу. Пригодится, если контекст проекта живёт в markdown-файлах.
claude mcp add --env VAULT_PATH=<VAULT_PATH> --env HIVE_OLLAMA_ENDPOINT=<HIVE_OLLAMA_ENDPOINT> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env HIVE_VAULT_SCOPES=<HIVE_VAULT_SCOPES> --transport stdio hive-vault -- uvx hive-vaultЧто делает Hive Vault
Сервер даёт ассистенту 17 инструментов, 5 ресурсов и 4 промпта для работы с хранилищем Obsidian. Вместо того чтобы загружать всё содержимое в контекст, он читает только нужные заметки — по запросу. Знания остаются в хранилище между сессиями, так что ассистент не начинает каждый раз с нуля.
Нужен Python 3.12+ и каталог с markdown-файлами. Без VAULT_PATH сервер запустится, но инструменты хранилища будут возвращать ошибку — установить можно сразу, а настроить позже. Если внутри хранилища инициализирован git, записи через vault_write и vault_patch коммитятся; без него файлы всё равно попадут на диск, только без коммита. Для delegate_task и capture_lesson понадобится OpenAI-совместимый эндпоинт /v1, заданный через HIVE_WORKER_BASE_URL, HIVE_WORKER_API_KEY и HIVE_WORKER_MODEL.
Есть необязательный режим демона: один долгоживущий процесс hive serve владеет хранилищем, а сессии подключаются через hive client. Порт по умолчанию выбирается автоматически из диапазона 49152..65535, переопределяется через HIVE_DAEMON_PORT — и в демоне, и в окружении каждого клиента. Пока не закрыт вопрос #456, демон не стоит разворачивать на многопользовательских хостах без доверия к пользователям.
Какие задачи решает
- найти нужную заметку в хранилище Obsidian по запросу
- сохранить заметку в хранилище из сессии ассистента
- пропатчить существующий markdown-файл, не открывая редактор
- сделать коммит изменений хранилища в конце сессии
- отдать часть работы воркеру через OpenAI-совместимый эндпоинт
Примеры запросов агенту
- Покажи моё хранилище через
vault_list - Найди в хранилище заметки про архитектуру проекта
- Запиши итоги сессии в хранилище и сделай коммит
Как установить Hive Vault
Командой платформы
claude mcp add --env VAULT_PATH=<VAULT_PATH> --env HIVE_OLLAMA_ENDPOINT=<HIVE_OLLAMA_ENDPOINT> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env HIVE_VAULT_SCOPES=<HIVE_VAULT_SCOPES> --transport stdio hive-vault -- uvx hive-vaultВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hive-vault <команда>
Командой платформы
codex mcp add hive-vault --env VAULT_PATH=<VAULT_PATH> --env HIVE_OLLAMA_ENDPOINT=<HIVE_OLLAMA_ENDPOINT> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env HIVE_VAULT_SCOPES=<HIVE_VAULT_SCOPES> -- uvx hive-vaultВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hive-vault <команда>
Файл настроек
{
"mcpServers": {
"hive-vault": {
"command": "uvx",
"args": [
"hive-vault"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>",
"HIVE_OLLAMA_ENDPOINT": "<HIVE_OLLAMA_ENDPOINT>",
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"HIVE_VAULT_SCOPES": "<HIVE_VAULT_SCOPES>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hive-vault <команда>
Файл настроек
{
"servers": {
"hive-vault": {
"type": "stdio",
"command": "uvx",
"args": [
"hive-vault"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>",
"HIVE_OLLAMA_ENDPOINT": "<HIVE_OLLAMA_ENDPOINT>",
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"HIVE_VAULT_SCOPES": "<HIVE_VAULT_SCOPES>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hive-vault <команда>
Командой платформы
gemini mcp add -e VAULT_PATH=<VAULT_PATH> -e HIVE_OLLAMA_ENDPOINT=<HIVE_OLLAMA_ENDPOINT> -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -e HIVE_VAULT_SCOPES=<HIVE_VAULT_SCOPES> hive-vault uvx hive-vaultВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hive-vault <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hive Vault
Как установить Hive Vault в Claude Code?
Выполните claude mcp add hive-vault -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- uvx hive-vault. Если нужен свой путь к хранилищу и другие переменные, используйте расширенный вариант: `claude mcp add --env VAULT_PATH=<VAULT_PATH> --env HIVE_OLLAMA_ENDPOINT=<HIVE_OLLAMA_ENDPOINT> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env HIVE_VAULT_SCOPES=<HIVE_VAULT_SCOPES> --transport stdio hive-vault -- uvx hive-vault`.
Что делает Hive Vault?
Связывает ИИ-ассистента с хранилищем Obsidian и отдаёт заметки по запросу: 17 инструментов, 5 ресурсов и 4 промпта. Контекст не загружается целиком, поэтому знания проекта остаются в хранилище между сессиями.
Что нужно для работы Hive Vault?
Python 3.12+ и каталог с markdown-файлами. git внутри хранилища рекомендован: без него записи идут на диск без коммита. Для delegate_task и capture_lesson нужен OpenAI-совместимый эндпоинт /v1 и переменные HIVE_WORKER_BASE_URL, HIVE_WORKER_API_KEY, HIVE_WORKER_MODEL.
