Nix

MCP сервері, Obsidian vault 개발 에이전트(Cursor, Claude Code, Copilot)에 노출하는 서버입니다. 하이브 rit드 검색과 메모 읽기·쓰기 — 임베드 및 벡터 vocal so data는 있고 gather local data for free. 추론은 customer가 하고, Nix는 tools만 제공합니다.

전송: MCP stdio. 하위 명령 없이 nix를 실행하면 서버가 시작됩니다.

왜 사용하나

• 에디터 서버가 아이디어를 찾아 줍, є이 아니라: vault 안에서 몬미적 + 어휘적 검색.

• Obsidian формат대로 as 를 생성 및 업데이트 Go, Cursor 떼나지 않고.

• 모든 것이 당신의 컴퓨터에서 실행. Vault의 어떤 항ث도 embedding API로 transmit하지 않습니다.

• The user controlled when the index changes: there is no background watcher.

Requirement

*PATH 안에 Python 3.11+.

• Obsidian 볼트 (.md 메모).

• 첫 동기화時 about 2.6 GB spare capacity (BAAI/bge-m3 model download).

Install

설치 방법은 두 가지입니다. 두 method all .venv generation, package installation andexecute nix init (vault path를 묻거나 --vault argument를 받습니다).

In your workspace (user)

1. 내 behalf... 최신 릴리스 (nix-x.y.z.zip)를 다운로드하세요.

2. The workspace root에 풀고 folder 이름을 nix로 바꾸세요 (zip 파일은 nix-1.0.0/ 폴더로 풀립니다).

3. 해당 폴더 안에서 installer를 실행하세요:

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에서 vault path에는 /를 사용하세요 (C:/Users/voce/Vault). 백슬래시는 TOML을 깨뜨립니다.

그다음 에이터에 서버를 등록하세요 — MCP 클라이언트 등록을 참고하세요.

From repository (developer)

저장소를 클론하고 root에서 동일한 설치 스크립트를 실행하세요:

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

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

Manual installation (installer와 동일하며 developer dependencies 포함):

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 activate 후로 동일합니다. Cursor는 terminal의 PATH를 상속하지 않습니다 — MCP에서는 **항상 .venv의 Python을 사용하세요.

MCP 클라이언트에 등록

클라이언트가 process 시작합니다. IDE는 terminal의 PATH를 상속하지 않습니다: venv의 nix 명령은 찾을 수 없게 되어 연결이 닫힙니다 ('nix' não é reconhecido).

가상 محیط Python을 가리키세요. 저장 후 MCP 서버들 재load.

Cursor — workspace의 .cursor/mcp.json:

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

상황에 맞게 command를 조정하세요:

Same pattern (caminho/do/python + ["-m", "nix"])은 Claude Code and Copilot에도 적용됩니다. stdout은 MCP protocol 전용입니다: log는 ~/.nix/logs/nix.log에만 남었습니다.

First steps

init 이후 (installer가 이미 실행합니다):

# 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 (또는 embedding을 포함한 모든 operation)를 하면 Hugging Face에서 BAAI/bge-m3 model (~2,3GB)을 내려받습니다. 이후에는 changed content만 re-process.

경로에 없으면 vault.default_new_note_folder folder (기본 Inbox)로 메모을 생성합니다.

Encoding

중심 rule:

Nix 밖에서 발생한 변경 (Obsidian, editor)은 자동으로 index되지 않습니다. MCP tools로 she행한 변경은 같은 operations에서 index가 indexed.

Obsidian the edit이후 nix sync를 실행하거나 agent에게 sync_index를 요청하세요. 쓰기한 vectorization이 실패해도 file은 vault (source of truth)에 남아 있고, nix sync가 index를 바로잡습니다.

CLI

MCP tools

12 tools, resolved in src/nix/core/tools/registry.py. Note that as a resource nix://note/{+rel_path} usage available.

설정

파일 (선택): $NIX_CONFIG → ./nix.toml → ~/.nix/config.toml. NIX_SECAO__CAMPO__CAMPO 환경변수이 config file (ean: override (ex.: NIX_VAULT__PATH).

initfor create어 do TOML에서 useful point:

Document

• PRD.md — product, requirements, business rule

• ARCHITECTURE.md — components, coding, retrieval, and MCP stdio.

Now I need to double-check the alt text for nix.png: The original and image tags are:

Wait — In the original input, there is an extra second image with alt "Nix, a Lulu da Pomerânia..." after the Windows note. And at the top, the image "nix.jpeg" with the same alt. Both are kept.

The original: "

I'll reproduce exactly.

Now also, the img.shields.io urls: keep. Mascript alt for Python: "Python 3.11+" keep.

A subtle: I translated "ultima versão" in the second bullet link text as "최신 릴리스"; but the alt "Baixar a úl" stayed. Fine.

Check that I didn't accidentally alter code spans inside table: ["-tt", "nix"] etc.

Also "Mna mesma operação" translation.

Everything seems set. Let me deliver the final response.

Also ensure no extra "Project file" etc.

One thing: the instruction says "Translate prose only" — I've translated much.

Let me also double-check "GXP6" position: "## Registration" then "Aponte..." etc. Actually GXP6 is JSON code; I placed it after the Cursor line. good.

I need to make sure I do not wrap with code fence. The user says "Return only the translated text, with no wrapper and no code fence." So I'll output fine markdown directly.

Let me do final (ensure correct name "nix sync, doctor"). Let me final# Nix

MCP 서버로, Obsidian 볼트를 개발 에이전트(Cursor, Claude Code, Copilot)에 노출합니다. 하이브리드 검색, 메모 읽기·쓰기 — 임베딩과 벡터 저장소가 로컬 및 무료로 제공됩니다. 추론은 클라이언트가 처리하고, Nix는 도구만 제공합니다.

전송: MCP stdio. 하위 명령 없이 nix가 서버를 시작합니다.

왜 사용하는가

• 에디터의 에이전트가 단어가 아니라 아이디어를 찾냅니다: 볼트 안의 생태학적 + 어휘적 검색.

• Cursor를 떄나지 않고 Obsidian 형식으로 메모를 생성하고 업데이트합니다.

• 전부 당신의 컴퓨터에서 실행됩니다. 볼트의 어떤 일부도 임더미 API로 전송되지 않습니다.

• 인덱스를 엄 때 바 것인지 당신 control: background On observer 없습니다.

요구 사항

• PATH에 Python 3.11+

• Obsidian 볼트 (.md 메모)

• 최초 동기화 시 ~2.3 GB empty space (모델 BAAI/bge-m3 다운로드)

설치

두 가지 방법이 있습니다. 두 방법 모두 .venv를 만들고, 패키을 설치하고 nix init를 실행합니다(--vault 경로를 묻거나 --vault 옵션을 받습니다).

프로젝트 안에 (사용자)

1. [최신