apple-numbers-mcp 0.5.0 → 0.6.0

package/README.md

@@ -703,7 +703,9 @@ Contributions are welcome! Please open an issue or PR at [github.com/sweetrb/app
 
 ## Related Projects
 
-- [apple-mail-mcp](https://github.com/sweetrb/apple-mail-mcp) — MCP server for Apple Mail
-- [apple-notes-mcp](https://github.com/sweetrb/apple-notes-mcp) — MCP server for Apple Notes
-- [apple-photos-mcp](https://github.com/sweetrb/apple-photos-mcp) — MCP server for Apple Photos
+Part of a family of macOS MCP servers:
+
+- [apple-mail-mcp](https://github.com/sweetrb/apple-mail-mcp) — MCP server for Apple Mail (read, search, send, and organize email)
+- [apple-notes-mcp](https://github.com/sweetrb/apple-notes-mcp) — MCP server for Apple Notes (create, search, update, and export notes)
+- [apple-photos-mcp](https://github.com/sweetrb/apple-photos-mcp) — MCP server for Apple Photos (query metadata and export originals)
 - [numbers-parser](https://pypi.org/project/numbers-parser/) — The Python library that powers this server

package/build/utils/python.d.ts

@@ -2,7 +2,7 @@ export interface PythonResult<T = unknown> {
     data?: T;
     error?: string;
 }
-/** Reset the cached Python path (useful for testing). */
+/** Reset cached interpreter + bootstrap state (useful for testing). */
 export declare function _resetPythonCache(): void;
 export declare function runNumbersReader<T = unknown>(command: string, args: string[], timeoutMs?: number): PythonResult<T>;
 export declare function checkDependencies(): {

package/build/utils/python.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/utils/python.ts"],"names":[],"mappings":"AA+CA,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,yDAAyD;AACzD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAcD,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,SAAQ,GAChB,YAAY,CAAC,CAAC,CAAC,CAiCjB;AAED,wBAAgB,iBAAiB,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAcpE"}
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/utils/python.ts"],"names":[],"mappings":"AA+DA,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAsKD,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,SAAQ,GAChB,YAAY,CAAC,CAAC,CAAC,CAkBjB;AAED,wBAAgB,iBAAiB,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAepE"}

package/build/utils/python.js

@@ -1,31 +1,68 @@
 import { execSync, execFileSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+// pip/display name vs. the importable module name (underscore).
+const PACKAGE = "numbers-parser";
+const MODULE = "numbers_parser";
+const ENV_PREFIX = "APPLE_NUMBERS_MCP";
 function getProjectRoot() {
-    // Walk up from build/utils/ or src/utils/ to project root
+    // build/utils/ or src/utils/ -> project root
     return join(__dirname, "..", "..");
 }
-// Resolve path to the Python helper script
 function getScriptPath() {
     return join(getProjectRoot(), "src", "utils", "numbers_reader.py");
 }
+function venvPythonPath() {
+    return join(getProjectRoot(), "venv", "bin", "python3");
+}
+function requirementsPath() {
+    return join(getProjectRoot(), "requirements.txt");
+}
+function setupScriptPath() {
+    return join(getProjectRoot(), "scripts", "setup.sh");
+}
+// Written by scripts/setup.sh after a successful install; holds a copy of the
+// requirements.txt the venv was built against, so we can detect a stale venv
+// after a package update changes requirements.
+function depsMarkerPath() {
+    return join(getProjectRoot(), "venv", ".deps-ok");
+}
+function readIfExists(p) {
+    try {
+        return existsSync(p) ? readFileSync(p, "utf8") : null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
- * Find the best Python executable. Preference order:
- *   1. Project-local venv (./venv/bin/python3)
- *   2. System python3
- *   3. System python
+ * True when the venv exists AND was built against the CURRENT requirements.txt.
+ * A package update that changes requirements invalidates the marker, so the
+ * server knows to rebuild rather than run against stale deps.
  */
-function findPython() {
-    const projectRoot = getProjectRoot();
-    const venvPython = join(projectRoot, "venv", "bin", "python3");
-    // Prefer the project venv — it has numbers-parser installed
-    if (existsSync(venvPython)) {
-        return venvPython;
-    }
-    // Fall back to system Python
+function venvIsReady() {
+    if (!existsSync(venvPythonPath()))
+        return false;
+    const reqs = readIfExists(requirementsPath());
+    // If requirements.txt isn't present (unexpected), trust an existing venv.
+    if (reqs === null)
+        return true;
+    const marker = readIfExists(depsMarkerPath());
+    return marker !== null && marker.trim() === reqs.trim();
+}
+let cachedPython = null;
+let readyConfirmed = false;
+let bootstrapAttempted = false;
+/** Reset cached interpreter + bootstrap state (useful for testing). */
+export function _resetPythonCache() {
+    cachedPython = null;
+    readyConfirmed = false;
+    bootstrapAttempted = false;
+}
+function findSystemPython() {
     for (const cmd of ["python3", "python"]) {
         try {
             execSync(`${cmd} --version`, { stdio: "pipe" });
@@ -37,15 +74,101 @@ function findPython() {
     }
     throw new Error('Python 3 not found. Run "npm run setup" to create a venv, or ensure python3 is on PATH.');
 }
-let cachedPython = null;
-/** Reset the cached Python path (useful for testing). */
-export function _resetPythonCache() {
+/**
+ * Resolve a Python interpreter. The project venv is cached once present (it's
+ * stable); a system-Python fallback is deliberately NOT cached, so a venv
+ * created later (e.g. by auto-bootstrap, or a manual `npm run setup`) is picked
+ * up on the very next call WITHOUT requiring a server restart.
+ */
+function resolvePython() {
+    if (cachedPython && existsSync(cachedPython))
+        return cachedPython;
     cachedPython = null;
+    const venv = venvPythonPath();
+    if (existsSync(venv)) {
+        cachedPython = venv;
+        return venv;
+    }
+    return findSystemPython();
+}
+function isTrueish(v) {
+    return v !== undefined && v !== "" && v !== "0" && v.toLowerCase() !== "false";
+}
+/** Auto-bootstrap is off under tests, or when explicitly disabled via env. */
+function autoSetupDisabled() {
+    if (process.env.VITEST || process.env.NODE_ENV === "test")
+        return true;
+    return isTrueish(process.env[`${ENV_PREFIX}_NO_AUTO_SETUP`]);
+}
+function bootstrapTimeoutMs() {
+    const raw = process.env[`${ENV_PREFIX}_SETUP_TIMEOUT`];
+    if (raw !== undefined) {
+        const n = Number(raw);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return 5 * 60 * 1000; // 5 minutes — pip install of numbers-parser can be slow.
+}
+/**
+ * Create or refresh the venv by running scripts/setup.sh. Returns true on
+ * success. Progress is logged to STDERR only — stdout is the MCP protocol
+ * channel and must never be written to.
+ */
+function bootstrapVenv() {
+    bootstrapAttempted = true;
+    const setup = setupScriptPath();
+    if (!existsSync(setup))
+        return false;
+    console.error(`[numbers-mcp] ${PACKAGE} not ready — setting up the Python venv (one-time; this can take a minute)…`);
+    try {
+        const out = execFileSync("bash", [setup], {
+            encoding: "utf-8",
+            timeout: bootstrapTimeoutMs(),
+            stdio: ["ignore", "pipe", "pipe"],
+            env: process.env,
+        });
+        const last = out.trim().split("\n").pop() ?? "";
+        console.error(`[numbers-mcp] Python venv ready. ${last}`.trim());
+        cachedPython = null;
+        readyConfirmed = false;
+        return true;
+    }
+    catch (err) {
+        const e = err;
+        const detail = (e.stderr?.toString() || e.stdout?.toString() || e.message || "").trim();
+        console.error(`[numbers-mcp] Automatic venv setup failed: ${detail.split("\n").pop() ?? detail}`);
+        return false;
+    }
+}
+/**
+ * Ensure the Python deps are ready, auto-bootstrapping the venv if it's missing
+ * or stale (and auto-setup isn't disabled). Cheap and idempotent: once the venv
+ * is confirmed ready it short-circuits, and bootstrap is attempted at most once
+ * per process.
+ */
+function ensureReady() {
+    if (readyConfirmed)
+        return;
+    if (venvIsReady()) {
+        readyConfirmed = true;
+        return;
+    }
+    if (bootstrapAttempted || autoSetupDisabled())
+        return;
+    if (bootstrapVenv() && venvIsReady()) {
+        readyConfirmed = true;
+    }
+}
+function looksLikeMissingDep(message) {
+    return /not installed|No module named|ModuleNotFoundError/i.test(message);
+}
+function setupHint() {
+    return `Run: npm run setup (or set ${ENV_PREFIX}_NO_AUTO_SETUP=0 to allow automatic setup).`;
 }
 const DEFAULT_MAX_BUFFER_BYTES = 50 * 1024 * 1024; // 50MB for large spreadsheets
 /** Max stdout bytes from the Python sidecar, overridable via env for huge files. */
 function getMaxBuffer() {
-    const raw = process.env.APPLE_NUMBERS_MCP_MAX_BUFFER;
+    const raw = process.env[`${ENV_PREFIX}_MAX_BUFFER`];
     if (raw !== undefined) {
         const n = Number(raw);
         if (Number.isFinite(n) && n > 0)
@@ -53,12 +176,11 @@ function getMaxBuffer() {
     }
     return DEFAULT_MAX_BUFFER_BYTES;
 }
-export function runNumbersReader(command, args, timeoutMs = 30000) {
-    const python = cachedPython ?? (cachedPython = findPython());
+function execReader(command, args, timeoutMs) {
+    const python = resolvePython();
     const scriptPath = getScriptPath();
     const fullArgs = [scriptPath, command, ...args];
-    const debug = process.env.DEBUG || process.env.VERBOSE;
-    if (debug) {
+    if (process.env.DEBUG || process.env.VERBOSE) {
         console.error(`[numbers-mcp] ${python} ${fullArgs.join(" ")}`);
     }
     try {
@@ -76,25 +198,51 @@ export function runNumbersReader(command, args, timeoutMs = 30000) {
     }
     catch (err) {
         const error = err;
-        if (error.stderr?.includes("numbers-parser not installed")) {
-            return { error: "numbers-parser not installed. Run: npm run setup" };
+        const stderr = error.stderr?.toString().trim() ?? "";
+        if (stderr.includes(`${PACKAGE} not installed`) || looksLikeMissingDep(stderr)) {
+            return { error: `${PACKAGE} not installed. ${setupHint()}` };
         }
         if (error.message?.includes("ETIMEDOUT") || error.message?.includes("timed out")) {
             return { error: `Operation timed out after ${timeoutMs}ms. File may be very large.` };
         }
+        // Surface the Python traceback when there is one — without it the user just
+        // sees "Command failed: <python> <args>" with no clue what actually broke.
+        if (stderr) {
+            return { error: stderr };
+        }
         return { error: error.message || "Unknown error executing Python script" };
     }
 }
+export function runNumbersReader(command, args, timeoutMs = 30000) {
+    ensureReady();
+    const result = execReader(command, args, timeoutMs);
+    // Belt-and-suspenders: if the deps still look missing and we haven't tried a
+    // bootstrap yet, attempt it once and retry — covers a venv that exists but is
+    // missing the package, which the marker check alone wouldn't catch.
+    if (result.error &&
+        looksLikeMissingDep(result.error) &&
+        !bootstrapAttempted &&
+        !autoSetupDisabled()) {
+        if (bootstrapVenv()) {
+            return execReader(command, args, timeoutMs);
+        }
+    }
+    return result;
+}
 export function checkDependencies() {
+    ensureReady();
     try {
-        const python = cachedPython ?? (cachedPython = findPython());
-        const version = execSync(`${python} -c "import numbers_parser; print(numbers_parser.__version__)"`, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
-        return { ok: true, message: `All dependencies available (numbers-parser ${version})` };
+        const python = resolvePython();
+        const version = execSync(`${python} -c "import ${MODULE}; print(${MODULE}.__version__)"`, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        return { ok: true, message: `All dependencies available (${PACKAGE} ${version})` };
     }
     catch {
         return {
             ok: false,
-            message: "numbers-parser not installed. Run: npm run setup",
+            message: `${PACKAGE} not installed. ${setupHint()}`,
         };
     }
 }

package/build/utils/python.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-numbers-mcp",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "MCP server for reading and writing Apple Numbers (.numbers) spreadsheet files",
   "type": "module",
   "main": "build/index.js",

package/scripts/setup.sh

@@ -43,4 +43,8 @@ echo "==> Installing numbers-parser..."
 echo "==> Verifying installation..."
 "$VENV_DIR/bin/python3" -c "import numbers_parser; print(f'    numbers-parser {numbers_parser.__version__} installed')"
 
+# Record which requirements.txt this venv was built against, so the server can
+# detect a stale venv after an update changes requirements and rebuild itself.
+cp "$PROJECT_ROOT/requirements.txt" "$VENV_DIR/.deps-ok"
+
 echo "==> Done! Python venv ready."