# Hive Vault

Подключает ИИ-ассистента к хранилищу Obsidian и выдаёт заметки по запросу, а не грузит всё сразу. Пригодится, если контекст проекта живёт в markdown-файлах.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Автор: mlorentedev
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mlorentedev/hive
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/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, демон не стоит разворачивать на многопользовательских хостах без доверия к пользователям.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `VAULT_PATH`, `HIVE_OLLAMA_ENDPOINT`, `OPENROUTER_API_KEY`, `HIVE_VAULT_SCOPES` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- найти нужную заметку в хранилище Obsidian по запросу
- сохранить заметку в хранилище из сессии ассистента
- пропатчить существующий markdown-файл, не открывая редактор
- сделать коммит изменений хранилища в конце сессии
- отдать часть работы воркеру через OpenAI-совместимый эндпоинт

## Примеры запросов агенту
- Покажи моё хранилище через `vault_list`
- Найди в хранилище заметки про архитектуру проекта
- Запиши итоги сессии в хранилище и сделай коммит

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md