Nix

Сервер MCP, который предоставляет хранилище Obsidian агентам разработки (Cursor, Claude Code, Copilot). Гибридный поиск, чтение и запись заметок — с эмбеддингами и векторной базой данных локально и бесплатно. Рассуждения остаются на стороне клиента; Nix только предоставляет инструменты.

Транспорт: MCP stdio. Без подкоманды, nix запускает сервер.

Зачем использовать

• Агент редактора находит идеи, а не только слова: семантический + лексический поиск в хранилище.

• Создаёт и обновляет заметки в формате Obsidian, не выходя из Cursor.

• Всё работает на вашей машине. Ни один фрагмент хранилища не отправляется в API эмбеддингов.

• Вы контролируете, когда меняется индекс: нет фонового наблюдателя.

Требования

• Python 3.11+ в PATH

• Хранилище Obsidian (заметки .md)

• ~2,3 ГБ свободного места при первой синхронизации (загрузка модели BAAI/bge-m3)

Установка

Есть два пути. Оба создают .venv, устанавливают пакет и запускают nix init (запрашивает путь к хранилищу или принимает --vault).

В вашем проекте (пользователь)

1. Скачайте последний релиз (nix-x.y.z.zip).

2. Распакуйте в корень рабочей области и переименуйте папку в nix (zip поставляется как nix-1.0.0/).

3. Запустите установщик внутри этой папки:

cd nix
setup.bat
:: ou, se já souber o vault:
setup.bat --vault "C:/Users/voce/Vault"

cd nix
chmod +x setup.sh
./setup.sh
# ou: ./setup.sh --vault "$HOME/Vault"

В Windows используйте косую черту / в пути к хранилищу (C:/Users/voce/Vault). Обратная косая черта ломает TOML.

Затем зарегистрируйте сервер в редакторе — см. Регистрация в MCP-клиенте.

Из репозитория (разработчик)

Клонируйте репозиторий и запустите тот же установщик в корне:

setup.bat
:: ou: setup.bat --vault "C:/Users/voce/Vault"

chmod +x setup.sh
./setup.sh
# ou: ./setup.sh --vault "$HOME/Vault"

Ручная установка (эквивалент установщика, с зависимостями для разработки):

python -m venv .venv
# Windows (Git Bash): source .venv/Scripts/activate
# Linux/macOS:        source .venv/bin/activate

pip install -r requirements-dev.txt
pip install -e .
python -m nix init                # ou: python -m nix init --vault "C:/Users/voce/Vault"

nix и python -m nix эквивалентны после активации venv. Cursor не наследует PATH из терминала — в MCP всегда используйте Python из .venv.

Регистрация в MCP-клиенте

Клиент запускает процесс. IDE не наследует PATH из терминала: команда nix из venv не находится, и соединение закрывается ('nix' не распознан).

Укажите Python из виртуального окружения. Перезагрузите MCP-серверы после сохранения.

Cursor — .cursor/mcp.json в рабочей области:

{
  "mcpServers": {
    "nix": {
      "command": "${workspaceFolder}/nix/.venv/Scripts/python.exe",
      "args": ["-m", "nix"]
    }
  }
}

Настройте command в зависимости от ситуации:

Тот же шаблон (путь/к/python + ["-m", "nix"]) применим к Claude Code и Copilot. stdout — это протокол MCP: логи только в ~/.nix/logs/nix.log.

Первые шаги

После init (установщик уже запускает это):

# Windows
.venv\Scripts\python.exe -m nix doctor
.venv\Scripts\python.exe -m nix sync
.venv\Scripts\python.exe -m nix status

# Linux / macOS
.venv/bin/python -m nix doctor
.venv/bin/python -m nix sync
.venv/bin/python -m nix status

Первая sync (или любая операция, которая создаёт эмбеддинги) загружает модель BAAI/bge-m3 (~2,3 ГБ) с Hugging Face. При последующих обрабатывается только то, что изменилось.

Новые заметки без папки в пути попадают в vault.default_new_note_folder (по умолчанию Inbox).

Индексация

Это центральное правило:

Изменения, сделанные вне Nix (Obsidian, редактор), не индексируются автоматически. Изменения, сделанные инструментами MCP, обновляют индекс в той же операции.

После редактирования в Obsidian запустите nix sync или попросите агента выполнить sync_index. Если векторизация записи не удалась, файл остаётся в хранилище (источник истины), а nix sync исправляет индекс.

CLI

Инструменты MCP

Двенадцать инструментов, определённых в src/nix/core/tools/registry.py. Заметки также доступны как ресурс nix://note/{+rel_path}.

Конфигурация

Файл (первый найденный): $NIX_CONFIG → ./nix.toml → ~/.nix/config.toml. Переменные NIX_SECAO__CAMPO переопределяют файл (например, NIX_VAULT__PATH).

Полезные пункты TOML, созданного init:

Документация

• PRD.md — продукт, требования и бизнес-правила

• ARCHITECTURE.md — компоненты, индексация, поиск и MCP stdio