@nodex-studio/mcp 0.0.1

package/README.md

@@ -0,0 +1,96 @@
+# @nodex-studio/mcp
+
+stdio [Model Context Protocol](https://modelcontextprotocol.io) server for **Nodex** workspace/project/note (WPN) data. It calls the same HTTP JSON API as the web client:
+
+- **Cloud:** `nodex-sync-api` or Next colocated `/api/v1` (Mongo WPN + JWT).
+- **Local:** Electron **loopback** bridge on `127.0.0.1` (file vault), enabled with `NODEX_WPN_LOCAL_HTTP=1`.
+
+## Tools
+
+| Tool | Purpose |
+|------|---------|
+| `nodex_find_projects` | Find by project **name or UUID**; optional `workspaceQuery`. Returns `status` + `matches` with `path` `Workspace / Project`; `ambiguous` / `workspace_ambiguous` list all candidates. |
+| `nodex_find_notes` | Find by note **title or UUID**; optional `workspaceQuery` / `projectQuery`. Returns `path` `Workspace / Project / Title`; `ambiguous`, `workspace_ambiguous`, `project_ambiguous` as needed. |
+| `nodex_list_wpn` | `scope`: `workspaces` \| `projects`+`workspaceId` \| `notes`+`projectId` \| `full_tree` — same data as GET `/wpn/workspaces`, `/wpn/workspaces/…/projects`, `/wpn/projects/…/notes`. |
+| `nodex_resolve_note` | Match `workspaceName` + `projectName` + `noteTitle` (trim, case-insensitive) → canonical `noteId`. Errors with `candidates` if ambiguous. |
+| `nodex_get_note` | `GET /wpn/notes/:id` — full note including `content`. |
+| `nodex_write_note` | Discriminated `mode`: `patch_existing`, `create_root`, `create_child`, `create_sibling` (maps to `PATCH` / `POST` WPN routes). |
+
+**Binary / cloud assets:** sync-api `/me/assets` may return 501 until implemented; embed text in markdown or use URLs the host can fetch. Local assets stay on disk under the project folder (Electron).
+
+## Environment
+
+### Cloud (Cursor / Claude Desktop / Windsurf / CI)
+
+- `NODEX_SYNC_API_BASE` — must include `/api/v1` (e.g. `http://127.0.0.1:4010/api/v1` or `https://your-host/api/v1`).
+- `NODEX_ACCESS_TOKEN` **or** `NODEX_JWT` — raw JWT string (no `Bearer ` prefix).
+
+### Local (Electron file vault + MCP)
+
+1. Start Electron with a folder vault open.
+2. Set in the **main** process env: `NODEX_WPN_LOCAL_HTTP=1` (see [`.env.example`](../../.env.example)). Optional: `NODEX_WPN_LOCAL_HTTP_PORT`, `NODEX_LOCAL_WPN_TOKEN`.
+3. Read `baseUrl` and `token` from Electron userData file `nodex-local-wpn-mcp.json` (written when the bridge starts), **or** set the same token in both Electron and MCP.
+4. MCP env:
+
+- `NODEX_LOCAL_WPN_URL` — e.g. `http://127.0.0.1:41234` (no `/api/v1` suffix for the bridge).
+- `NODEX_LOCAL_WPN_TOKEN` — Bearer secret matching the bridge.
+
+**Security:** Any local process can reach `127.0.0.1`; the bearer token is the gate. Disable the bridge when not needed (`NODEX_WPN_LOCAL_HTTP` unset).
+
+## Run
+
+```bash
+# from repo root (after npm install)
+npm run build -w @nodex-studio/mcp
+node packages/nodex-mcp/dist/cli.js
+# or
+npm run dev -w @nodex-studio/mcp
+```
+
+## Example: Cursor MCP (`mcp.json`)
+
+Cloud:
+
+```json
+{
+  "mcpServers": {
+    "nodex": {
+      "command": "node",
+      "args": ["/absolute/path/to/nodex/packages/nodex-mcp/dist/cli.js"],
+      "env": {
+        "NODEX_SYNC_API_BASE": "http://127.0.0.1:4010/api/v1",
+        "NODEX_ACCESS_TOKEN": "<jwt-from-login>"
+      }
+    }
+  }
+}
+```
+
+Local (after Electron wrote `nodex-local-wpn-mcp.json` or you set a fixed token):
+
+```json
+{
+  "mcpServers": {
+    "nodex-local": {
+      "command": "node",
+      "args": ["/absolute/path/to/nodex/packages/nodex-mcp/dist/cli.js"],
+      "env": {
+        "NODEX_LOCAL_WPN_URL": "http://127.0.0.1:41234",
+        "NODEX_LOCAL_WPN_TOKEN": "<same-as-electron>"
+      }
+    }
+  }
+}
+```
+
+## CI
+
+Use a machine-safe JWT (service account or long-lived test user) with `NODEX_SYNC_API_BASE` + `NODEX_ACCESS_TOKEN`. Do not commit secrets; inject via CI secrets.
+
+## Tests
+
+```bash
+npm test -w @nodex-studio/mcp
+# from repo root:
+npm run test:mcp
+```

package/bin/nodex-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli.js";

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runMcpStdioServer } from "./server.js";
+void runMcpStdioServer().catch((err) => {
+    console.error("[nodex-mcp]", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACrC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve HTTP base + bearer for WPN calls.
+ *
+ * Cloud: NODEX_SYNC_API_BASE (must include `/api/v1`) + NODEX_ACCESS_TOKEN or NODEX_JWT.
+ * Local: NODEX_LOCAL_WPN_URL (e.g. http://127.0.0.1:41234) + NODEX_LOCAL_WPN_TOKEN.
+ */
+export type WpnHttpConfig = {
+    baseUrl: string;
+    bearerToken: string;
+};
+export declare function loadWpnHttpConfig(): WpnHttpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAcF,wBAAgB,iBAAiB,IAAI,aAAa,CAwBjD"}

package/dist/config.js

@@ -0,0 +1,30 @@
+function trimSlash(s) {
+    return s.replace(/\/+$/, "");
+}
+function normalizeSyncBase(raw) {
+    const t = trimSlash(raw.trim());
+    if (t.endsWith("/api/v1")) {
+        return t;
+    }
+    return `${t}/api/v1`;
+}
+export function loadWpnHttpConfig() {
+    const localUrl = process.env.NODEX_LOCAL_WPN_URL?.trim();
+    const localToken = process.env.NODEX_LOCAL_WPN_TOKEN?.trim();
+    if (localUrl && localToken) {
+        return { baseUrl: trimSlash(localUrl), bearerToken: localToken };
+    }
+    const syncRaw = process.env.NODEX_SYNC_API_BASE?.trim();
+    if (!syncRaw) {
+        throw new Error("Set either (NODEX_LOCAL_WPN_URL + NODEX_LOCAL_WPN_TOKEN) for Electron loopback, or " +
+            "NODEX_SYNC_API_BASE (+ NODEX_ACCESS_TOKEN or NODEX_JWT) for cloud sync-api.");
+    }
+    const token = process.env.NODEX_ACCESS_TOKEN?.trim() ||
+        process.env.NODEX_JWT?.trim() ||
+        "";
+    if (!token) {
+        throw new Error("Cloud mode requires NODEX_ACCESS_TOKEN or NODEX_JWT (Bearer value, no 'Bearer ' prefix).");
+    }
+    return { baseUrl: normalizeSyncBase(syncRaw), bearerToken: token };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,GAAG,CAAC,SAAS,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACzD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC;IAC7D,IAAI,QAAQ,IAAI,UAAU,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,qFAAqF;YACnF,6EAA6E,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GACT,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE;QACtC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE;QAC7B,EAAE,CAAC;IACL,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACrE,CAAC"}

package/dist/find-wpn.d.ts

@@ -0,0 +1,66 @@
+import type { WpnHttpClient } from "./wpn-client.js";
+import type { WpnNoteWithContextRow } from "./wpn-client.js";
+/** RFC-style UUID v1–v5 (loose check for id vs name disambiguation). */
+export declare function isLikelyUuid(s: string): boolean;
+export type ProjectPathRow = {
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    workspaceName: string;
+    path: string;
+};
+export type WorkspaceRef = {
+    workspaceId: string;
+    workspaceName: string;
+};
+export type NotePathRow = {
+    noteId: string;
+    title: string;
+    type: string;
+    projectId: string;
+    projectName: string;
+    workspaceId: string;
+    workspaceName: string;
+    path: string;
+};
+export declare function findProjectsByQuery(client: WpnHttpClient, query: string, workspaceQuery?: string): Promise<{
+    status: "none";
+    message: string;
+} | {
+    status: "workspace_ambiguous";
+    message: string;
+    workspaces: WorkspaceRef[];
+} | {
+    status: "ambiguous";
+    message: string;
+    matches: ProjectPathRow[];
+} | {
+    status: "unique";
+    matches: ProjectPathRow[];
+}>;
+export declare function findNotesByQuery(rows: WpnNoteWithContextRow[], query: string, workspaceQuery?: string, projectQuery?: string): {
+    status: "none";
+    message: string;
+} | {
+    status: "workspace_ambiguous";
+    message: string;
+    workspaces: WorkspaceRef[];
+} | {
+    status: "project_ambiguous";
+    message: string;
+    projects: {
+        projectId: string;
+        projectName: string;
+        workspaceId: string;
+        workspaceName: string;
+        path: string;
+    }[];
+} | {
+    status: "ambiguous";
+    message: string;
+    matches: NotePathRow[];
+} | {
+    status: "unique";
+    matches: NotePathRow[];
+};
+//# sourceMappingURL=find-wpn.d.ts.map

package/dist/find-wpn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-wpn.d.ts","sourceRoot":"","sources":["../src/find-wpn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAKF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CACN;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,GAC9E;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,GACnE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE,CAClD,CA2EA;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,qBAAqB,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GAEnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,GAC9E;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,GAClK;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,GAChE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,WAAW,EAAE,CAAA;CAAE,CAsH/C"}

package/dist/find-wpn.js

@@ -0,0 +1,188 @@
+import { norm } from "./resolve-note.js";
+/** RFC-style UUID v1–v5 (loose check for id vs name disambiguation). */
+export function isLikelyUuid(s) {
+    const t = s.trim();
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(t);
+}
+export async function findProjectsByQuery(client, query, workspaceQuery) {
+    const q = query.trim();
+    if (!q) {
+        return { status: "none", message: "Empty query." };
+    }
+    const workspaces = (await client.getWorkspaces());
+    let scopedWs = workspaces;
+    if (workspaceQuery !== undefined && workspaceQuery.trim() !== "") {
+        const wq = workspaceQuery.trim();
+        if (isLikelyUuid(wq)) {
+            scopedWs = workspaces.filter((w) => w.id === wq);
+        }
+        else {
+            scopedWs = workspaces.filter((w) => norm(w.name ?? "") === norm(wq));
+        }
+        if (scopedWs.length === 0) {
+            return {
+                status: "none",
+                message: `No workspace matched "${workspaceQuery}".`,
+            };
+        }
+        if (scopedWs.length > 1) {
+            return {
+                status: "workspace_ambiguous",
+                message: "Multiple workspaces match that name; pass workspace id or a more specific workspaceQuery.",
+                workspaces: scopedWs.map((w) => ({
+                    workspaceId: w.id,
+                    workspaceName: w.name ?? "",
+                })),
+            };
+        }
+    }
+    const flat = [];
+    for (const w of scopedWs) {
+        const projects = (await client.getProjects(w.id));
+        const wname = w.name ?? "";
+        for (const p of projects) {
+            const pname = p.name ?? "";
+            flat.push({
+                projectId: p.id,
+                projectName: pname,
+                workspaceId: w.id,
+                workspaceName: wname,
+                path: `${wname} / ${pname}`,
+            });
+        }
+    }
+    let matches;
+    if (isLikelyUuid(q)) {
+        matches = flat.filter((r) => r.projectId === q);
+    }
+    else {
+        matches = flat.filter((r) => norm(r.projectName) === norm(q));
+    }
+    if (matches.length === 0) {
+        return {
+            status: "none",
+            message: isLikelyUuid(q)
+                ? `No project with id "${q}".`
+                : `No project named "${query}" in the selected scope.`,
+        };
+    }
+    if (matches.length === 1) {
+        return { status: "unique", matches };
+    }
+    return {
+        status: "ambiguous",
+        message: "Multiple projects match; each row includes projectId and path (Workspace / Project). Pick one id or narrow workspaceQuery.",
+        matches,
+    };
+}
+export function findNotesByQuery(rows, query, workspaceQuery, projectQuery) {
+    const q = query.trim();
+    if (!q) {
+        return { status: "none", message: "Empty query." };
+    }
+    let filtered = rows;
+    if (workspaceQuery !== undefined && workspaceQuery.trim() !== "") {
+        const wq = workspaceQuery.trim();
+        if (isLikelyUuid(wq)) {
+            filtered = filtered.filter((r) => r.workspace_id === wq);
+        }
+        else {
+            const wsMatches = new Map();
+            for (const r of filtered) {
+                if (norm(r.workspace_name) === norm(wq)) {
+                    wsMatches.set(r.workspace_id, r.workspace_name);
+                }
+            }
+            if (wsMatches.size > 1) {
+                return {
+                    status: "workspace_ambiguous",
+                    message: "Multiple workspaces share that name; pass workspace id as workspaceQuery or disambiguate.",
+                    workspaces: [...wsMatches.entries()].map(([workspaceId, workspaceName]) => ({
+                        workspaceId,
+                        workspaceName,
+                    })),
+                };
+            }
+            filtered = filtered.filter((r) => norm(r.workspace_name) === norm(wq));
+        }
+        if (filtered.length === 0) {
+            return {
+                status: "none",
+                message: `No notes in a workspace matching "${workspaceQuery}".`,
+            };
+        }
+    }
+    if (projectQuery !== undefined && projectQuery.trim() !== "") {
+        const pq = projectQuery.trim();
+        if (isLikelyUuid(pq)) {
+            filtered = filtered.filter((r) => r.project_id === pq);
+        }
+        else {
+            const projBuckets = new Map();
+            for (const r of filtered) {
+                if (norm(r.project_name) !== norm(pq)) {
+                    continue;
+                }
+                const k = `${r.workspace_id}\0${r.project_id}`;
+                if (!projBuckets.has(k)) {
+                    const path = `${r.workspace_name} / ${r.project_name}`;
+                    projBuckets.set(k, {
+                        projectId: r.project_id,
+                        projectName: r.project_name,
+                        workspaceId: r.workspace_id,
+                        workspaceName: r.workspace_name,
+                        path,
+                    });
+                }
+            }
+            if (projBuckets.size > 1) {
+                return {
+                    status: "project_ambiguous",
+                    message: "Multiple projects match that name in scope; pass project id as projectQuery or narrow workspace.",
+                    projects: [...projBuckets.values()],
+                };
+            }
+            filtered = filtered.filter((r) => norm(r.project_name) === norm(pq));
+        }
+        if (filtered.length === 0) {
+            return {
+                status: "none",
+                message: `No notes in a project matching "${projectQuery}" in the current scope.`,
+            };
+        }
+    }
+    let matches;
+    if (isLikelyUuid(q)) {
+        matches = filtered.filter((r) => r.id === q);
+    }
+    else {
+        matches = filtered.filter((r) => norm(r.title) === norm(q));
+    }
+    const out = matches.map((r) => ({
+        noteId: r.id,
+        title: r.title,
+        type: r.type,
+        projectId: r.project_id,
+        projectName: r.project_name,
+        workspaceId: r.workspace_id,
+        workspaceName: r.workspace_name,
+        path: `${r.workspace_name} / ${r.project_name} / ${r.title}`,
+    }));
+    if (out.length === 0) {
+        return {
+            status: "none",
+            message: isLikelyUuid(q)
+                ? `No note with id "${q}" in the selected scope.`
+                : `No note titled "${query}" in the selected scope.`,
+        };
+    }
+    if (out.length === 1) {
+        return { status: "unique", matches: out };
+    }
+    return {
+        status: "ambiguous",
+        message: "Multiple notes match; each row includes noteId and path (Workspace / Project / Title). Pick one id or narrow filters.",
+        matches: out,
+    };
+}
+//# sourceMappingURL=find-wpn.js.map

package/dist/find-wpn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-wpn.js","sourceRoot":"","sources":["../src/find-wpn.ts"],"names":[],"mappings":"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"}

package/dist/find-wpn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find-wpn.test.d.ts.map

package/dist/find-wpn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-wpn.test.d.ts","sourceRoot":"","sources":["../src/find-wpn.test.ts"],"names":[],"mappings":""}

package/dist/find-wpn.test.js

@@ -0,0 +1,59 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { findNotesByQuery, isLikelyUuid } from "./find-wpn.js";
+describe("isLikelyUuid", () => {
+    it("accepts lowercase uuid", () => {
+        assert.equal(isLikelyUuid("550e8400-e29b-41d4-a716-446655440000"), true);
+    });
+    it("rejects plain title", () => {
+        assert.equal(isLikelyUuid("My Note"), false);
+    });
+});
+describe("findNotesByQuery", () => {
+    const idA = "550e8400-e29b-41d4-a716-446655440001";
+    const idB = "550e8400-e29b-41d4-a716-446655440002";
+    const rows = [
+        {
+            id: idA,
+            title: "Todo",
+            type: "markdown",
+            project_id: "p1",
+            project_name: "Core",
+            workspace_id: "w1",
+            workspace_name: "Main",
+        },
+        {
+            id: idB,
+            title: "Todo",
+            type: "markdown",
+            project_id: "p2",
+            project_name: "App",
+            workspace_id: "w1",
+            workspace_name: "Main",
+        },
+    ];
+    it("returns unique by title", () => {
+        const r = findNotesByQuery(rows, "todo", "main", "core");
+        assert.equal(r.status, "unique");
+        if (r.status === "unique") {
+            assert.equal(r.matches.length, 1);
+            assert.equal(r.matches[0].noteId, idA);
+            assert.equal(r.matches[0].path, "Main / Core / Todo");
+        }
+    });
+    it("returns ambiguous when same title in scope", () => {
+        const r = findNotesByQuery(rows, "todo");
+        assert.equal(r.status, "ambiguous");
+        if (r.status === "ambiguous") {
+            assert.equal(r.matches.length, 2);
+        }
+    });
+    it("returns unique by note id", () => {
+        const r = findNotesByQuery(rows, idB);
+        assert.equal(r.status, "unique");
+        if (r.status === "unique") {
+            assert.equal(r.matches[0].noteId, idB);
+        }
+    });
+});
+//# sourceMappingURL=find-wpn.test.js.map

package/dist/find-wpn.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-wpn.test.js","sourceRoot":"","sources":["../src/find-wpn.test.ts"],"names":[],"mappings":"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"}

package/dist/resolve-note.d.ts

@@ -0,0 +1,34 @@
+import type { WpnNoteWithContextRow } from "./wpn-client.js";
+export declare function norm(s: string): string;
+export type ResolveNoteInput = {
+    workspaceName: string;
+    projectName: string;
+    noteTitle: string;
+};
+export type ResolveNoteOk = {
+    ok: true;
+    noteId: string;
+    workspaceId: string;
+    workspaceName: string;
+    projectId: string;
+    projectName: string;
+    title: string;
+    type: string;
+};
+export type ResolveNoteAmbiguous = {
+    ok: false;
+    reason: "none" | "ambiguous";
+    candidates: {
+        noteId: string;
+        workspaceName: string;
+        projectName: string;
+        title: string;
+    }[];
+};
+export type ResolveNoteResult = ResolveNoteOk | ResolveNoteAmbiguous;
+/**
+ * Match workspace, project, and note title using trim + case-insensitive comparison
+ * (Unicode case-folding via `toLowerCase()`).
+ */
+export declare function resolveNoteFromCatalog(rows: WpnNoteWithContextRow[], input: ResolveNoteInput): ResolveNoteResult;
+//# sourceMappingURL=resolve-note.d.ts.map

package/dist/resolve-note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-note.d.ts","sourceRoot":"","sources":["../src/resolve-note.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,oBAAoB,CAAC;AAErE;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,qBAAqB,EAAE,EAC7B,KAAK,EAAE,gBAAgB,GACtB,iBAAiB,CAoCnB"}

package/dist/resolve-note.js

@@ -0,0 +1,42 @@
+export function norm(s) {
+    return s.trim().replace(/\s+/g, " ").toLowerCase();
+}
+/**
+ * Match workspace, project, and note title using trim + case-insensitive comparison
+ * (Unicode case-folding via `toLowerCase()`).
+ */
+export function resolveNoteFromCatalog(rows, input) {
+    const wn = norm(input.workspaceName);
+    const pn = norm(input.projectName);
+    const tn = norm(input.noteTitle);
+    const matches = rows.filter((r) => norm(r.workspace_name) === wn &&
+        norm(r.project_name) === pn &&
+        norm(r.title) === tn);
+    if (matches.length === 0) {
+        return { ok: false, reason: "none", candidates: [] };
+    }
+    if (matches.length > 1) {
+        return {
+            ok: false,
+            reason: "ambiguous",
+            candidates: matches.map((r) => ({
+                noteId: r.id,
+                workspaceName: r.workspace_name,
+                projectName: r.project_name,
+                title: r.title,
+            })),
+        };
+    }
+    const r = matches[0];
+    return {
+        ok: true,
+        noteId: r.id,
+        workspaceId: r.workspace_id,
+        workspaceName: r.workspace_name,
+        projectId: r.project_id,
+        projectName: r.project_name,
+        title: r.title,
+        type: r.type,
+    };
+}
+//# sourceMappingURL=resolve-note.js.map

package/dist/resolve-note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-note.js","sourceRoot":"","sources":["../src/resolve-note.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAgCD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAA6B,EAC7B,KAAuB;IAEvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE;QAC7B,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE;QAC3B,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CACvB,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,MAAM,EAAE,CAAC,CAAC,EAAE;gBACZ,aAAa,EAAE,CAAC,CAAC,cAAc;gBAC/B,WAAW,EAAE,CAAC,CAAC,YAAY;gBAC3B,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IACtB,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,CAAC,CAAC,EAAE;QACZ,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,aAAa,EAAE,CAAC,CAAC,cAAc;QAC/B,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC;AACJ,CAAC"}

package/dist/resolve-note.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-note.test.d.ts.map

package/dist/resolve-note.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-note.test.d.ts","sourceRoot":"","sources":["../src/resolve-note.test.ts"],"names":[],"mappings":""}

package/dist/resolve-note.test.js

@@ -0,0 +1,72 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { resolveNoteFromCatalog } from "./resolve-note.js";
+const rows = [
+    {
+        id: "a1",
+        title: "Spec",
+        type: "markdown",
+        project_id: "p1",
+        project_name: "Core",
+        workspace_id: "w1",
+        workspace_name: "Main",
+    },
+    {
+        id: "a2",
+        title: "Spec",
+        type: "markdown",
+        project_id: "p2",
+        project_name: "Core",
+        workspace_id: "w2",
+        workspace_name: "Other",
+    },
+];
+describe("resolveNoteFromCatalog", () => {
+    it("returns single match with case-insensitive names", () => {
+        const r = resolveNoteFromCatalog(rows, {
+            workspaceName: "main",
+            projectName: "  core ",
+            noteTitle: "SPEC",
+        });
+        assert.equal(r.ok, true);
+        if (r.ok) {
+            assert.equal(r.noteId, "a1");
+        }
+    });
+    it("returns none when title missing", () => {
+        const r = resolveNoteFromCatalog(rows, {
+            workspaceName: "Main",
+            projectName: "Core",
+            noteTitle: "Missing",
+        });
+        assert.equal(r.ok, false);
+        if (!r.ok) {
+            assert.equal(r.reason, "none");
+        }
+    });
+    it("returns ambiguous when same triple exists twice", () => {
+        const dup = [
+            ...rows,
+            {
+                id: "a3",
+                title: "Spec",
+                type: "markdown",
+                project_id: "p9",
+                project_name: "Core",
+                workspace_id: "w1",
+                workspace_name: "Main",
+            },
+        ];
+        const r = resolveNoteFromCatalog(dup, {
+            workspaceName: "Main",
+            projectName: "Core",
+            noteTitle: "Spec",
+        });
+        assert.equal(r.ok, false);
+        if (!r.ok) {
+            assert.equal(r.reason, "ambiguous");
+            assert.equal(r.candidates.length, 2);
+        }
+    });
+});
+//# sourceMappingURL=resolve-note.test.js.map

package/dist/resolve-note.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-note.test.js","sourceRoot":"","sources":["../src/resolve-note.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,IAAI,GAA4B;IACpC;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,MAAM;QACpB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,MAAM;KACvB;IACD;QACE,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,MAAM;QACpB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,OAAO;KACxB;CACF,CAAC;AAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,EAAE;YACrC,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;YACT,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,EAAE;YACrC,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAA4B;YACnC,GAAG,IAAI;YACP;gBACE,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,UAAU;gBAChB,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,MAAM;gBACpB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,MAAM;aACvB;SACF,CAAC;QACF,MAAM,CAAC,GAAG,sBAAsB,CAAC,GAAG,EAAE;YACpC,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export declare function runMcpStdioServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAyFA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuOvD"}

package/dist/server.js

@@ -0,0 +1,257 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadWpnHttpConfig } from "./config.js";
+import { findNotesByQuery, findProjectsByQuery } from "./find-wpn.js";
+import { resolveNoteFromCatalog } from "./resolve-note.js";
+import { errorResult, jsonResult } from "./text-result.js";
+import { WpnHttpClient } from "./wpn-client.js";
+const resolveInput = z.object({
+    workspaceName: z.string().describe("Workspace name (trimmed, case-insensitive match)"),
+    projectName: z.string().describe("Project name (trimmed, case-insensitive match)"),
+    noteTitle: z.string().describe("Note title (trimmed, case-insensitive match)"),
+});
+const getNoteInput = z.object({
+    noteId: z.string().describe("Canonical note UUID"),
+});
+const findProjectsInput = z.object({
+    query: z.string().describe("Project name or project UUID"),
+    workspaceQuery: z
+        .string()
+        .optional()
+        .describe("Optional workspace name or UUID to limit search (required if project name clashes across workspaces)."),
+});
+const findNotesInput = z.object({
+    query: z.string().describe("Note title or note UUID"),
+    workspaceQuery: z
+        .string()
+        .optional()
+        .describe("Optional workspace name or UUID to narrow results"),
+    projectQuery: z
+        .string()
+        .optional()
+        .describe("Optional project name or UUID to narrow results"),
+});
+const listWpnInput = z.discriminatedUnion("scope", [
+    z.object({ scope: z.literal("workspaces") }),
+    z.object({
+        scope: z.literal("projects"),
+        workspaceId: z.string().describe("Workspace id from scope=workspaces"),
+    }),
+    z.object({
+        scope: z.literal("notes"),
+        projectId: z.string().describe("Project id from scope=projects"),
+    }),
+    z.object({ scope: z.literal("full_tree") }),
+]);
+const writeNoteInput = z.discriminatedUnion("mode", [
+    z.object({
+        mode: z.literal("patch_existing"),
+        noteId: z.string(),
+        title: z.string().optional(),
+        content: z.string().optional(),
+        type: z.string().optional(),
+        metadata: z.record(z.string(), z.unknown()).nullable().optional(),
+    }),
+    z.object({
+        mode: z.literal("create_root"),
+        projectId: z.string(),
+        type: z.string(),
+        title: z.string().optional(),
+        content: z.string().optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }),
+    z.object({
+        mode: z.literal("create_child"),
+        projectId: z.string(),
+        anchorId: z.string(),
+        type: z.string(),
+        title: z.string().optional(),
+        content: z.string().optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }),
+    z.object({
+        mode: z.literal("create_sibling"),
+        projectId: z.string(),
+        anchorId: z.string(),
+        type: z.string(),
+        title: z.string().optional(),
+        content: z.string().optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }),
+]);
+export async function runMcpStdioServer() {
+    const cfg = loadWpnHttpConfig();
+    const client = new WpnHttpClient(cfg);
+    const mcp = new McpServer({ name: "nodex-mcp", version: "0.0.0" }, {
+        capabilities: {
+            tools: {},
+        },
+        instructions: "Nodex WPN tools: nodex_list_wpn lists workspaces / projects / notes or a full_tree; " +
+            "nodex_find_projects / nodex_find_notes resolve by name or UUID with path (Workspace / Project / Title) and ambiguity hints; " +
+            "nodex_resolve_note finds a noteId from workspace+project+title; nodex_get_note reads a note; " +
+            "nodex_write_note patches or creates notes. " +
+            "Configure NODEX_SYNC_API_BASE + NODEX_ACCESS_TOKEN (cloud) or NODEX_LOCAL_WPN_URL + NODEX_LOCAL_WPN_TOKEN (Electron loopback).",
+    });
+    mcp.registerTool("nodex_find_projects", {
+        description: "Find project(s) by name or id. Returns status unique | ambiguous | none | workspace_ambiguous; " +
+            "each match includes projectId, names, and path \"Workspace / Project\". On clash, all candidates are listed.",
+        inputSchema: findProjectsInput,
+    }, async (args) => {
+        try {
+            const result = await findProjectsByQuery(client, args.query, args.workspaceQuery);
+            return jsonResult(result);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return errorResult(msg);
+        }
+    });
+    mcp.registerTool("nodex_find_notes", {
+        description: "Find note(s) by title or id using GET /wpn/notes-with-context. Optional workspaceQuery / projectQuery narrow scope. " +
+            "Returns status unique | ambiguous | none | workspace_ambiguous | project_ambiguous; " +
+            "each match includes noteId, title, and path \"Workspace / Project / Title\".",
+        inputSchema: findNotesInput,
+    }, async (args) => {
+        try {
+            const rows = await client.getNotesWithContext();
+            const result = findNotesByQuery(rows, args.query, args.workspaceQuery, args.projectQuery);
+            return jsonResult(result);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return errorResult(msg);
+        }
+    });
+    mcp.registerTool("nodex_list_wpn", {
+        description: "List WPN data: workspaces (GET /wpn/workspaces), projects in a workspace, flat note tree for a project, or full_tree (all nested).",
+        inputSchema: listWpnInput,
+    }, async (args) => {
+        try {
+            if (args.scope === "workspaces") {
+                const workspaces = await client.getWorkspaces();
+                return jsonResult({ scope: "workspaces", workspaces });
+            }
+            if (args.scope === "projects") {
+                const projects = await client.getProjects(args.workspaceId);
+                return jsonResult({
+                    scope: "projects",
+                    workspaceId: args.workspaceId,
+                    projects,
+                });
+            }
+            if (args.scope === "notes") {
+                const notes = await client.getNotesFlat(args.projectId);
+                return jsonResult({ scope: "notes", projectId: args.projectId, notes });
+            }
+            const workspaces = await client.getWorkspaces();
+            const wsRows = workspaces;
+            const tree = [];
+            for (const w of wsRows) {
+                const projectsRaw = await client.getProjects(w.id);
+                const projects = projectsRaw;
+                const projectBlocks = [];
+                for (const p of projects) {
+                    const notes = await client.getNotesFlat(p.id);
+                    projectBlocks.push({ project: p, notes });
+                }
+                tree.push({ workspace: w, projects: projectBlocks });
+            }
+            return jsonResult({ scope: "full_tree", tree });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return errorResult(msg);
+        }
+    });
+    mcp.tool("nodex_resolve_note", "Resolve a note to its canonical UUID using workspace name, project name, and note title. " +
+        "Matching is trim + case-insensitive. Returns an error if zero or multiple notes match.", resolveInput.shape, async (args) => {
+        try {
+            const rows = await client.getNotesWithContext();
+            const r = resolveNoteFromCatalog(rows, {
+                workspaceName: args.workspaceName,
+                projectName: args.projectName,
+                noteTitle: args.noteTitle,
+            });
+            if (!r.ok) {
+                return errorResult(JSON.stringify({
+                    error: r.reason === "none"
+                        ? "No note matched workspace/project/title."
+                        : "Multiple notes matched; disambiguate titles or use noteId from candidates.",
+                    reason: r.reason,
+                    candidates: r.candidates,
+                }, null, 2));
+            }
+            return jsonResult({
+                noteId: r.noteId,
+                workspaceId: r.workspaceId,
+                workspaceName: r.workspaceName,
+                projectId: r.projectId,
+                projectName: r.projectName,
+                title: r.title,
+                type: r.type,
+            });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return errorResult(msg);
+        }
+    });
+    mcp.tool("nodex_get_note", "Fetch a single note by id (includes content and metadata).", getNoteInput.shape, async (args) => {
+        try {
+            const note = await client.getNote(args.noteId);
+            return jsonResult({ note });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return errorResult(msg);
+        }
+    });
+    mcp.registerTool("nodex_write_note", {
+        description: "Create or patch a note. Modes: patch_existing (PATCH), create_root | create_child | create_sibling (POST with relation).",
+        inputSchema: writeNoteInput,
+    }, async (args) => {
+        try {
+            if (args.mode === "patch_existing") {
+                const patch = {};
+                if (args.title !== undefined) {
+                    patch.title = args.title;
+                }
+                if (args.content !== undefined) {
+                    patch.content = args.content;
+                }
+                if (args.type !== undefined) {
+                    patch.type = args.type;
+                }
+                if (args.metadata !== undefined) {
+                    patch.metadata = args.metadata;
+                }
+                const note = await client.patchNote(args.noteId, patch);
+                return jsonResult({ ok: true, note });
+            }
+            const relation = args.mode === "create_root"
+                ? "root"
+                : args.mode === "create_child"
+                    ? "child"
+                    : "sibling";
+            const anchorId = args.mode === "create_root" ? undefined : args.anchorId;
+            const body = {
+                type: args.type,
+                relation,
+                anchorId,
+                title: args.title,
+                content: args.content,
+                metadata: args.metadata,
+            };
+            const created = await client.createNote(args.projectId, body);
+            return jsonResult({ ok: true, created });
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return errorResult(msg);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await mcp.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/text-result.d.ts

@@ -0,0 +1,11 @@
+/** MCP tool handler return shape (subset of CallToolResult). */
+export type ToolReturn = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+};
+export declare function jsonResult(obj: unknown): ToolReturn;
+export declare function errorResult(message: string): ToolReturn;
+//# sourceMappingURL=text-result.d.ts.map

package/dist/text-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-result.d.ts","sourceRoot":"","sources":["../src/text-result.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CASnD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAKvD"}

package/dist/text-result.js

@@ -0,0 +1,17 @@
+export function jsonResult(obj) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(obj, null, 2),
+            },
+        ],
+    };
+}
+export function errorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+//# sourceMappingURL=text-result.js.map

package/dist/text-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-result.js","sourceRoot":"","sources":["../src/text-result.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;aACnC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/wpn-client.d.ts

@@ -0,0 +1,51 @@
+import type { WpnHttpConfig } from "./config.js";
+export type WpnNoteWithContextRow = {
+    id: string;
+    title: string;
+    type: string;
+    project_id: string;
+    project_name: string;
+    workspace_id: string;
+    workspace_name: string;
+};
+export type WpnNoteDetail = {
+    id: string;
+    project_id: string;
+    parent_id: string | null;
+    type: string;
+    title: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    sibling_index: number;
+    created_at_ms: number;
+    updated_at_ms: number;
+};
+export declare class WpnHttpClient {
+    private readonly cfg;
+    constructor(cfg: WpnHttpConfig);
+    private url;
+    private headers;
+    private getJson;
+    getWorkspaces(): Promise<unknown[]>;
+    getProjects(workspaceId: string): Promise<unknown[]>;
+    getNotesFlat(projectId: string): Promise<unknown[]>;
+    getNotesWithContext(): Promise<WpnNoteWithContextRow[]>;
+    getNote(noteId: string): Promise<WpnNoteDetail>;
+    patchNote(noteId: string, patch: {
+        title?: string;
+        content?: string;
+        type?: string;
+        metadata?: Record<string, unknown> | null;
+    }): Promise<WpnNoteDetail>;
+    createNote(projectId: string, body: {
+        type: string;
+        relation: "root" | "child" | "sibling";
+        anchorId?: string;
+        title?: string;
+        content?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+    }>;
+}
+//# sourceMappingURL=wpn-client.d.ts.map

package/dist/wpn-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wpn-client.d.ts","sourceRoot":"","sources":["../src/wpn-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAE/C,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,OAAO;YAQD,OAAO;IAmBf,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAYnC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAYpD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAYnD,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAYvD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB/C,SAAS,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC3C,GACA,OAAO,CAAC,aAAa,CAAC;IAwBnB,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GACA,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CA0B3B"}

package/dist/wpn-client.js

@@ -0,0 +1,140 @@
+export class WpnHttpClient {
+    cfg;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    url(path) {
+        const p = path.startsWith("/") ? path : `/${path}`;
+        return `${this.cfg.baseUrl}${p}`;
+    }
+    headers() {
+        return {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.cfg.bearerToken}`,
+        };
+    }
+    async getJson(path, errLabel) {
+        const res = await fetch(this.url(path), {
+            method: "GET",
+            headers: this.headers(),
+        });
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new Error(`${errLabel}: invalid JSON (${res.status})`);
+        }
+        if (!res.ok) {
+            const err = body?.error ?? text.slice(0, 200);
+            throw new Error(`${errLabel} failed (${res.status}): ${err}`);
+        }
+        return body;
+    }
+    async getWorkspaces() {
+        const body = await this.getJson("/wpn/workspaces", "WPN GET workspaces");
+        const ws = body.workspaces;
+        if (!Array.isArray(ws)) {
+            throw new Error("WPN GET workspaces: missing workspaces array");
+        }
+        return ws;
+    }
+    async getProjects(workspaceId) {
+        const body = await this.getJson(`/wpn/workspaces/${encodeURIComponent(workspaceId)}/projects`, "WPN GET projects");
+        const p = body.projects;
+        if (!Array.isArray(p)) {
+            throw new Error("WPN GET projects: missing projects array");
+        }
+        return p;
+    }
+    async getNotesFlat(projectId) {
+        const body = await this.getJson(`/wpn/projects/${encodeURIComponent(projectId)}/notes`, "WPN GET notes");
+        const n = body.notes;
+        if (!Array.isArray(n)) {
+            throw new Error("WPN GET notes: missing notes array");
+        }
+        return n;
+    }
+    async getNotesWithContext() {
+        const body = await this.getJson("/wpn/notes-with-context", "WPN GET notes-with-context");
+        const notes = body.notes;
+        if (!Array.isArray(notes)) {
+            throw new Error("WPN GET notes-with-context: missing notes array");
+        }
+        return notes;
+    }
+    async getNote(noteId) {
+        const res = await fetch(this.url(`/wpn/notes/${encodeURIComponent(noteId)}`), {
+            method: "GET",
+            headers: this.headers(),
+        });
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new Error(`WPN get note: invalid JSON (${res.status})`);
+        }
+        if (!res.ok) {
+            const err = body?.error ?? text.slice(0, 200);
+            throw new Error(`WPN GET note failed (${res.status}): ${err}`);
+        }
+        const note = body.note;
+        if (!note || typeof note !== "object") {
+            throw new Error("WPN GET note: missing note object");
+        }
+        return note;
+    }
+    async patchNote(noteId, patch) {
+        const res = await fetch(this.url(`/wpn/notes/${encodeURIComponent(noteId)}`), {
+            method: "PATCH",
+            headers: this.headers(),
+            body: JSON.stringify(patch),
+        });
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new Error(`WPN patch note: invalid JSON (${res.status})`);
+        }
+        if (!res.ok) {
+            const err = body?.error ?? text.slice(0, 200);
+            throw new Error(`WPN PATCH note failed (${res.status}): ${err}`);
+        }
+        const note = body.note;
+        if (!note) {
+            throw new Error("WPN PATCH note: missing note in response");
+        }
+        return note;
+    }
+    async createNote(projectId, body) {
+        const res = await fetch(this.url(`/wpn/projects/${encodeURIComponent(projectId)}/notes`), {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        const text = await res.text();
+        let parsed;
+        try {
+            parsed = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new Error(`WPN create note: invalid JSON (${res.status})`);
+        }
+        if (!res.ok) {
+            const err = parsed?.error ?? text.slice(0, 200);
+            throw new Error(`WPN POST note failed (${res.status}): ${err}`);
+        }
+        const id = parsed.id;
+        if (typeof id !== "string" || !id) {
+            throw new Error("WPN POST note: missing id in response");
+        }
+        return { id };
+    }
+}
+//# sourceMappingURL=wpn-client.js.map

package/dist/wpn-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wpn-client.js","sourceRoot":"","sources":["../src/wpn-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@nodex-studio/mcp",
+  "version": "0.0.1",
+  "description": "MCP server (stdio) for Nodex WPN over HTTP — cloud sync-api or Electron loopback",
+  "type": "module",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "bin": {
+    "nodex-mcp": "bin/nodex-mcp.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test src/resolve-note.test.ts src/find-wpn.test.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}