apple-numbers-mcp 1.1.16 → 1.1.17

package/README.md

@@ -765,6 +765,11 @@ These are tracked for future releases. The underlying `numbers-parser` library h
 - Run `claude mcp list` to check for conflicting scopes; project-scope `.mcp.json` outranks a user-scope `apple-numbers` entry, and a local-scope entry outranks both.
 - If the server is listed as pending, approve the project-scope server when Claude Code prompts.
 
+### Every tool is rejected with "invalid outputSchema … unsupported dialect"
+- Full symptom: `Tool '<name>' has an invalid outputSchema: JSON Schema declares an unsupported dialect ("$schema": "http://json-schema.org/draft-07/schema#"). The default validator supports JSON Schema 2020-12 only.` The host refuses **every** tool, so the server looks completely dead even though it started fine.
+- **Upgrade to 1.1.17 or newer.** MCP standardized on JSON Schema 2020-12, and hosts now reject any other dialect; releases before 1.1.17 advertised draft-07 because the MCP SDK emits it. 1.1.17 advertises `https://json-schema.org/draft/2020-12/schema` on every tool's `inputSchema` and `outputSchema`.
+- If you installed via `npx -y apple-numbers-mcp`, restart the host to pick up the new version; if you run from a clone, `git pull && pnpm install && pnpm run build`.
+
 ### "File not found"
 - Check the path; expand `~` if your shell isn't doing it.
 - Ensure the file extension is `.numbers`.

package/build/index.js

@@ -22362,6 +22362,117 @@ function loadFileConfig(env = process.env, path = fileConfigPath(env)) {
   return applied;
 }
 
+// src/utils/jsonSchemaDialect.ts
+var JSON_SCHEMA_2020_12 = "https://json-schema.org/draft/2020-12/schema";
+var DEFINITIONS_REF_PREFIX = "#/definitions/";
+var SCHEMA_MAP_KEYWORDS = /* @__PURE__ */ new Set([
+  "properties",
+  "patternProperties",
+  "$defs",
+  "dependentSchemas"
+]);
+var DATA_KEYWORDS = /* @__PURE__ */ new Set([
+  "enum",
+  "const",
+  "default",
+  "examples",
+  "required",
+  "dependentRequired"
+]);
+function isPlainObject3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function convertSchemaMap(node) {
+  if (!isPlainObject3(node)) return node;
+  const out = {};
+  for (const [name, subschema] of Object.entries(node)) out[name] = convertNode(subschema);
+  return out;
+}
+function convertNode(node) {
+  if (Array.isArray(node)) return node.map(convertNode);
+  if (!isPlainObject3(node)) return node;
+  const hasTupleItems = Array.isArray(node.items);
+  const out = {};
+  for (const [key, value] of Object.entries(node)) {
+    switch (key) {
+      case "$schema":
+        break;
+      case "definitions":
+        out.$defs = convertSchemaMap(value);
+        break;
+      case "$ref":
+        out.$ref = typeof value === "string" && value.startsWith(DEFINITIONS_REF_PREFIX) ? "#/$defs/" + value.slice(DEFINITIONS_REF_PREFIX.length) : value;
+        break;
+      case "items":
+        if (hasTupleItems) out.prefixItems = value.map(convertNode);
+        else out.items = convertNode(value);
+        break;
+      case "additionalItems":
+        if (hasTupleItems) out.items = convertNode(value);
+        break;
+      case "dependencies": {
+        const dependentRequired = {};
+        const dependentSchemas = {};
+        if (isPlainObject3(value)) {
+          for (const [property, dependency] of Object.entries(value)) {
+            if (Array.isArray(dependency)) dependentRequired[property] = dependency;
+            else dependentSchemas[property] = convertNode(dependency);
+          }
+        }
+        if (Object.keys(dependentRequired).length > 0) out.dependentRequired = dependentRequired;
+        if (Object.keys(dependentSchemas).length > 0) out.dependentSchemas = dependentSchemas;
+        break;
+      }
+      case "exclusiveMinimum":
+      case "exclusiveMaximum": {
+        const bound = key === "exclusiveMinimum" ? node.minimum : node.maximum;
+        if (value === true && typeof bound === "number") out[key] = bound;
+        else if (value !== false) out[key] = convertNode(value);
+        break;
+      }
+      case "minimum":
+        if (node.exclusiveMinimum === true) break;
+        out.minimum = convertNode(value);
+        break;
+      case "maximum":
+        if (node.exclusiveMaximum === true) break;
+        out.maximum = convertNode(value);
+        break;
+      default:
+        if (DATA_KEYWORDS.has(key)) out[key] = value;
+        else if (SCHEMA_MAP_KEYWORDS.has(key)) out[key] = convertSchemaMap(value);
+        else out[key] = convertNode(value);
+    }
+  }
+  return out;
+}
+function toJsonSchema2020_12(schema) {
+  if (!isPlainObject3(schema)) return schema;
+  return {
+    $schema: JSON_SCHEMA_2020_12,
+    ...convertNode(schema)
+  };
+}
+function normalizeOutgoingMessage(message) {
+  if (!isPlainObject3(message)) return message;
+  const result = message.result;
+  if (!isPlainObject3(result) || !Array.isArray(result.tools)) return message;
+  const tools = result.tools.map((tool) => {
+    if (!isPlainObject3(tool)) return tool;
+    const next = { ...tool };
+    if (isPlainObject3(tool.inputSchema)) next.inputSchema = toJsonSchema2020_12(tool.inputSchema);
+    if (isPlainObject3(tool.outputSchema))
+      next.outputSchema = toJsonSchema2020_12(tool.outputSchema);
+    return next;
+  });
+  return { ...message, result: { ...result, tools } };
+}
+function withJsonSchema2020_12(transport) {
+  const originalSend = transport.send.bind(transport);
+  transport.send = (message, options) => originalSend(normalizeOutgoingMessage(message), options);
+  return transport;
+}
+
 // src/index.ts
 loadFileConfig();
 var __filename2 = fileURLToPath2(import.meta.url);
@@ -23200,7 +23311,7 @@ async function main() {
   process.on("unhandledRejection", (reason) => {
     console.error("[unhandledRejection]", reason);
   });
-  const transport = new StdioServerTransport();
+  const transport = withJsonSchema2020_12(new StdioServerTransport());
   await server.connect(transport);
   console.error(`apple-numbers-mcp v${version2} running on stdio`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-numbers-mcp",
-  "version": "1.1.16",
+  "version": "1.1.17",
   "description": "MCP server for Apple Numbers - read, write, search, and format .numbers spreadsheets via Claude and other AI assistants",
   "type": "module",
   "main": "build/index.js",