Nix

Obsidian の vault を開発エージェント（Cursor、Claude Code、Copilot）に公開する MCP サーバーです。ノートの読み書きに加えてハイブリッド検索（意味検索＋語彙検索）を提供し、エンベディングとベクトルデータベースはローカルで無料です。推論処理はクライアント側で行われ、Nix は単にツールを提供します。

トランスポート: MCP stdio。サブコマンドなしで、nix がサーバーを起動します。

なぜ使うか

• エディタのエージェントが単語ではなくアイデアを見つけます（vault 内の意味検索＋語彙検索）。

• Cursor から離れずに、Obsidian の形式でノートを作成・更新できます。

• すべて自分のマシン上で動作します。vault の内容が embedding API に送信されることはありません。

• インデックスを更新するタイミングは自分で制御できます。バックグラウンドの watcher はありません。

要件

• PATH に Python 3.11+ が存在すること

• Obsidian の vault（.md ノート）が存在すること

• 初回同期時に約2.3 GB の空き容量（モデル BAAI/bge-m3 のダウンロード用）

インストール

2つの方法があります。どちらも .venv を作成し、パッケージをインストールして nix init を実行します（vault のパスを対話的に尋ねるか、--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 では vault のパスにスラッシュ / を使用します（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 では常に .venv の Python を使用してください。

MCP クライアントでの登録

クライアントがプロセスを起動します。IDE はターミナルの PATH を引き継ぎません。そのため、venv 内の nix コマンドが見つからず、接続が閉じます（'nix' não é reconhecido）。

仮想環境の Python を指定してください。保存後に MCP サーバーを再読み込みします。

Cursor — ワークスペースの .cursor/mcp.json:

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

必要に応じて command を調整します:

同じパターン（caminho/do/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（または embedding を実行する操作）は、Hugging Face からモデル BAAI/bge-m3（約2.3 GB）をダウンロードします。2回目以降は、変更されたものだけが再処理されます。

パスにフォルダが含まれない新しいノートは、vault.default_new_note_folder（デフォルト Inbox）に移動されます。

インデックス化

以下のルールが基本です:

Nix の外で（Obsidian、エディタ）行った変更は、自動ではインデックスされません。MCP ツールによる変更は、同じ操作内でインデックスを更新します。

Obsidian で編集した後は、nix sync を実行するか、エージェントに sync_index を依頼してください。書き込みのベクトル化に失敗しても、ファイルは vault（正真の情報源）に残り、nix sync によってインデックスが修正されます。

CLI

MCP ツール

12個のツールが src/nix/core/tools/registry.py に定義されています。ノートは nix://note/{+rel_path} リソースとしても利用できます。

設定

設定ファイル（最初に見つかったもの）: $NIX_CONFIG → ./nix.toml → ~/.nix/config.toml。環境変数 NIX_SECAO__CAMPO でファイルを上書きできます（例: NIX_VAULT__PATH）。

init によって生成される TOML の主な設定項目:

ドキュメント

• PRD.md — 製品、要件、ビジネスルール

• ARCHITECTURE.md — コンポーネント、インデックス化、検索、MCP stdio