pkm-mcp-server 1.3.1 → 1.3.3

package/CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.3.3] - 2026-03-21
+
+### Fixed
+- Use `pkm-mcp-server@latest` in npx registration command to ensure users always get the latest version (previously npx could serve stale cached versions)
+
+## [1.3.2] - 2026-03-21
+
+### Fixed
+- Fix `claude mcp add` argument ordering — the `-e` flag is variadic and was greedily consuming the server name. Moved `--` separator before the server name to terminate option parsing.
+
 ## [1.3.1] - 2026-03-21
 
 ### Fixed

package/README.md

@@ -114,13 +114,13 @@ node cli.js init
 If you prefer to skip the wizard, register directly with the Claude CLI:
 
 ```bash
-claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault obsidian-pkm -- npx -y pkm-mcp-server
+claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault -- obsidian-pkm npx -y pkm-mcp-server@latest
 ```
 
 For a source install:
 
 ```bash
-claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault obsidian-pkm -- node /absolute/path/to/cli.js
+claude mcp add -s user -e VAULT_PATH=/absolute/path/to/your/vault -- obsidian-pkm node /absolute/path/to/cli.js
 ```
 
 Verify with `claude mcp list` — you should see `obsidian-pkm: ... - Connected`.
@@ -134,7 +134,7 @@ claude mcp remove obsidian-pkm
 claude mcp add -s user \
   -e VAULT_PATH=/absolute/path/to/your/vault \
   -e OPENAI_API_KEY=sk-... \
-  obsidian-pkm -- npx -y pkm-mcp-server
+  -- obsidian-pkm npx -y pkm-mcp-server@latest
 ```
 
 This enables `vault_semantic_search` and `vault_suggest_links`. Uses `text-embedding-3-large` with a SQLite + sqlite-vec index stored at `.obsidian/semantic-index.db`. The index rebuilds automatically — delete the DB file to force a full re-embed.
@@ -280,7 +280,7 @@ All paths passed to tools are relative to vault root. The server includes path s
 You need C++ build tools. See [Prerequisites](#prerequisites) for your platform. On Linux, `sudo apt install build-essential python3` usually fixes it.
 
 **Server starts but all tool calls fail with ENOENT**
-Your `VAULT_PATH` is wrong or missing. The server validates this at startup and exits with a clear error. Re-register with the correct path: `claude mcp remove obsidian-pkm && claude mcp add -s user -e VAULT_PATH=/correct/path obsidian-pkm -- npx -y pkm-mcp-server`
+Your `VAULT_PATH` is wrong or missing. The server validates this at startup and exits with a clear error. Re-register with the correct path: `claude mcp remove obsidian-pkm && claude mcp add -s user -e VAULT_PATH=/correct/path -- obsidian-pkm npx -y pkm-mcp-server@latest`
 
 **`vault_write` says "no templates available"**
 Run `pkm-mcp-server init` to install templates, or copy the `templates/` files from this repo into your vault's `05-Templates/` directory. The server loads templates from there at startup.

package/init.js

@@ -133,7 +133,7 @@ export function buildMcpAddArgs({ vaultPath, openaiKey, installType }) {
   if (openaiKey) {
     args.push("-e", `OPENAI_API_KEY=${openaiKey}`);
   }
-  args.push("obsidian-pkm", "--", installType.command, ...installType.args);
+  args.push("--", "obsidian-pkm", installType.command, ...installType.args);
   return args;
 }
 
@@ -192,7 +192,7 @@ export async function dirSize(dirPath) {
 export function detectInstallType(filePath) {
   const thisFile = filePath || fileURLToPath(import.meta.url);
   if (thisFile.includes("node_modules")) {
-    return { command: "npx", args: ["-y", "pkm-mcp-server"] };
+    return { command: "npx", args: ["-y", "pkm-mcp-server@latest"] };
   }
   const cliPath = path.join(path.dirname(thisFile), "cli.js");
   return { command: "node", args: [cliPath] };
@@ -318,7 +318,7 @@ Nothing is written until you confirm each step. Press Ctrl+C at any time to canc
     const hasClaude = await checkClaudeCli();
     if (!hasClaude) {
       const installType = detectInstallType();
-      const manualCmd = `claude mcp add -s user -e VAULT_PATH=${vaultPath} obsidian-pkm -- ${installType.command} ${installType.args.join(" ")}`;
+      const manualCmd = `claude mcp add -s user -e VAULT_PATH=${vaultPath} -- obsidian-pkm ${installType.command} ${installType.args.join(" ")}`;
       console.log(`
   Claude Code CLI not found on PATH. To register manually, run:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pkm-mcp-server",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "MCP server for Obsidian vault integration with Claude Code — 19 tools for notes, search, and graph traversal",
   "main": "cli.js",
   "exports": {