neuro-vault-mcp 5.5.3 → 7.0.0

package/README.md

@@ -97,6 +97,8 @@ For module wiring and internal data flow, see [docs/architecture/module-structur
 npm install -g neuro-vault-mcp
 ```
 
+### Single vault
+
 Add to your MCP client config (here: Claude Code's `~/.claude/settings.json`):
 
 ```json
@@ -110,6 +112,38 @@ Add to your MCP client config (here: Claude Code's `~/.claude/settings.json`):
 }
 ```
 
+### 🗂 Multi-vault — two vaults, one server
+
+Pass `--vault` once per vault:
+
+```bash
+neuro-vault-mcp \
+  --vault /Users/me/Vaults/Sandbox \
+  --vault /Users/me/Vaults/TeamWiki
+```
+
+Two vaults registered, with names `Sandbox` and `TeamWiki`. In your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "neuro-vault": {
+      "command": "neuro-vault-mcp",
+      "args": ["--vault", "/Users/me/Vaults/Sandbox", "--vault", "/Users/me/Vaults/TeamWiki"]
+    }
+  }
+}
+```
+
+Two vaults cannot share the same directory basename — the basename doubles as the alias and must be unique. If you have a basename collision, rename one of the directories.
+
+With multiple vaults registered:
+
+- **Every tool** accepts an optional `vault: "<name>"` parameter to target a specific vault.
+- **`search_notes`, `query_notes`, and `get_vault_overview`** fan out across all registered vaults when `vault` is omitted. The response shape switches to `results_by_vault: [...]` (one entry per vault) plus `skipped_vaults: [...]` for any vault the tool could not reach.
+- **All other tools** (writes, reads of specific paths, single-vault diagnostics) require an explicit `vault` in multi-vault mode. Omitting it returns `VAULT_REQUIRED`.
+- **Semantic fan-out** silently skips vaults whose Smart Connections `.smart-env/multi/` index is unavailable. Targeting such a vault explicitly with `vault: "<name>"` returns `SEMANTIC_INDEX_NOT_FOUND`.
+
 Then ask your assistant:
 
 > "What did I write about building AI agents?"
@@ -122,13 +156,15 @@ For other clients (Cursor / Windsurf / npx), see [docs/guide/installation.md](./
 
 ## 📚 Documentation
 
+> **Every tool accepts an optional `vault` parameter.** In multi-vault mode, `search_notes`, `query_notes`, and `get_vault_overview` fan out across all registered vaults when `vault` is omitted.
+
 User guide lives in [`docs/guide/`](./docs/guide/README.md):
 
 - [Installation](./docs/guide/installation.md)
 - [Semantic Search](./docs/guide/semantic-search.md) — `search_notes`, `get_similar_notes`, `find_duplicates`, `get_stats`
 - [Vault Operations](./docs/guide/vault-operations.md) — note CRUD, daily notes, properties, tags, structured queries (`query_notes`), vault snapshot (`get_vault_overview`)
 - [Routing Between Tools](./docs/guide/routing.md)
-- [Configuration](./docs/guide/configuration.md) — CLI args, troubleshooting, limitations, **migration to 2.0**, development
+- [Configuration](./docs/guide/configuration.md) — CLI args, troubleshooting, limitations, development
 
 Architecture / internals: [`docs/architecture/`](./docs/architecture/).
 

package/dist/cli.d.ts

@@ -2,11 +2,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 
-interface BasenameIndex {
-    resolve(target: string): string | null;
-    resolveAll(target: string): string[];
-}
-
 interface SmartBlock {
     key: string;
     heading: string;
@@ -19,14 +14,6 @@ interface SmartSource {
     blocks: SmartBlock[];
 }
 
-interface CorpusSnapshot {
-    sources: Map<string, SmartSource>;
-    basenameIndex: BasenameIndex;
-}
-interface SmartConnectionsCorpusIndex {
-    snapshot(): Promise<CorpusSnapshot>;
-}
-
 type ReadNotesField = 'frontmatter' | 'content';
 interface ReadNotesItemSuccess {
     path: string;
@@ -130,19 +117,19 @@ interface SearchEngine {
         threshold: number;
     }): DuplicatePair[];
 }
-type PathExistsCheck = (vaultRelativePath: string) => Promise<boolean>;
 
-interface SemanticModuleDeps {
-    corpusFactory?: (smartEnvPath: string, modelKey: string) => Promise<SmartConnectionsCorpusIndex>;
-    embeddingServiceFactory?: (modelId: string) => EmbeddingProvider;
-    searchEngine?: SearchEngine;
-    pathExists?: PathExistsCheck;
-    readNoteContent?: (vaultRelativePath: string) => Promise<string>;
-    graph?: WikilinkGraphIndex;
-    vaultReaderFactory?: (opts: {
-        vaultRoot: string;
-    }) => VaultReader;
-    listMatchingPaths?: ListMatchingPaths;
+interface ReplaceInNoteInput {
+    path: string;
+    find: string;
+    content: string;
+}
+interface ReplaceFullBodyInput {
+    path: string;
+    content: string;
+}
+interface VaultWriter {
+    replaceInNote(input: ReplaceInNoteInput): Promise<void>;
+    replaceFullBody(input: ReplaceFullBodyInput): Promise<void>;
 }
 
 type NoteIdentifier = {
@@ -204,6 +191,48 @@ interface VaultProvider {
     listTags(): Promise<TagListEntry[]>;
 }
 
+interface BasenameIndex {
+    resolve(target: string): string | null;
+    resolveAll(target: string): string[];
+}
+
+interface CorpusSnapshot {
+    sources: Map<string, SmartSource>;
+    basenameIndex: BasenameIndex;
+}
+interface SmartConnectionsCorpusIndex {
+    snapshot(): Promise<CorpusSnapshot>;
+}
+
+interface IVaultEntryDeps {
+    readerFactory: (opts: {
+        vaultRoot: string;
+    }) => VaultReader;
+    writerFactory: (opts: {
+        vaultRoot: string;
+    }) => VaultWriter;
+    graphFactory: (opts: {
+        reader: VaultReader;
+    }) => WikilinkGraphIndex;
+    listMatchingPathsFactory: (opts: {
+        reader: VaultReader;
+        graph: WikilinkGraphIndex;
+    }) => ListMatchingPaths;
+    providerFactory: (opts: {
+        vaultName: string;
+        binaryPath?: string;
+    }) => VaultProvider;
+    corpusFactory: (opts: {
+        smartEnvPath: string;
+        modelKey: string;
+    }) => Promise<SmartConnectionsCorpusIndex>;
+}
+
+interface ISemanticModuleDeps {
+    embeddingServiceFactory?: (modelId: string) => EmbeddingProvider;
+    searchEngine?: SearchEngine;
+}
+
 type ExecFn = (binary: string, args: string[], options: {
     timeout: number;
 }) => Promise<{
@@ -217,35 +246,15 @@ interface ObsidianCLIProviderOptions {
     exec?: ExecFn;
 }
 
-interface ReplaceInNoteInput {
-    path: string;
-    find: string;
-    content: string;
-}
-interface ReplaceFullBodyInput {
-    path: string;
-    content: string;
-}
-interface VaultWriter {
-    replaceInNote(input: ReplaceInNoteInput): Promise<void>;
-    replaceFullBody(input: ReplaceFullBodyInput): Promise<void>;
-}
-
-interface OperationsModuleDeps {
+interface IOperationsModuleDeps {
     vaultProviderFactory?: (opts: ObsidianCLIProviderOptions) => VaultProvider;
-    vaultReaderFactory?: (opts: {
-        vaultRoot: string;
-    }) => VaultReader;
-    vaultWriterFactory?: (opts: {
-        vaultRoot: string;
-    }) => VaultWriter;
-    graph?: WikilinkGraphIndex;
 }
 
 type ToolServer = Pick<McpServer, 'registerTool' | 'registerResource' | 'connect'>;
 interface NeuroVaultStartupDependencies {
-    semantic?: SemanticModuleDeps;
-    operations?: OperationsModuleDeps;
+    semantic?: ISemanticModuleDeps;
+    operations?: IOperationsModuleDeps;
+    vaultEntryDeps?: Partial<IVaultEntryDeps>;
     serverFactory?: (instructions: string) => ToolServer;
     transportFactory?: () => StdioServerTransport;
 }