@kaiord/mcp 4.3.2 → 4.4.0

package/dist/bin/kaiord-mcp.js

@@ -5,8 +5,8 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/server/create-server.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { dirname as dirname2, join } from "path";
-import { fileURLToPath } from "url";
+import { dirname as dirname3, join } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/adapters/stderr-logger.ts
@@ -90,15 +90,18 @@ var registerConvertFilePrompt = (server) => {
   );
 };
 
-// src/resources/krd-format-spec.ts
+// src/utils/find-spec-file.ts
 import { existsSync, readFileSync } from "fs";
-import { resolve } from "path";
-var SPEC_URI = "kaiord://docs/krd-format";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 var DOCS_URL = "https://github.com/pablo-albaladejo/kaiord/blob/main/docs/krd-format.md";
+var __dirname2 = dirname(fileURLToPath(import.meta.url));
 var findSpecFile = () => {
   const candidates = [
     resolve(process.cwd(), "docs/krd-format.md"),
-    resolve(process.cwd(), "packages/mcp/docs/krd-format.md")
+    resolve(process.cwd(), "packages/mcp/docs/krd-format.md"),
+    resolve(__dirname2, "../../../docs/krd-format.md"),
+    resolve(__dirname2, "../../../../docs/krd-format.md")
   ];
   for (const path of candidates) {
     if (existsSync(path)) {
@@ -107,6 +110,9 @@ var findSpecFile = () => {
   }
   return `KRD format specification not found locally. See: ${DOCS_URL}`;
 };
+
+// src/resources/krd-format-spec.ts
+var SPEC_URI = "kaiord://docs/krd-format";
 var registerKrdFormatSpecResource = (server) => {
   const spec = findSpecFile();
   server.resource(
@@ -264,7 +270,7 @@ import {
   readFile as fsReadFile,
   writeFile as fsWriteFile
 } from "fs/promises";
-import { dirname } from "path";
+import { dirname as dirname2 } from "path";
 var DANGEROUS_CHARS = /[\0|;&`$(){}!\n\r]/;
 var PATH_TRAVERSAL = /(?:^|[/\\])\.\.(?:[/\\]|$)/;
 var validatePathSecurity = (inputPath) => {
@@ -298,7 +304,7 @@ var readFileAsText = async (path) => {
 };
 var writeOutputFile = async (path, data) => {
   validatePathSecurity(path);
-  await mkdir(dirname(path), { recursive: true });
+  await mkdir(dirname2(path), { recursive: true });
   if (data instanceof Uint8Array) {
     await fsWriteFile(path, data);
   } else {
@@ -578,6 +584,17 @@ var registerExtractWorkoutTool = (server, logger) => {
   );
 };
 
+// src/tools/kaiord-get-format-spec.ts
+var registerGetFormatSpecTool = (server) => {
+  const spec = findSpecFile();
+  server.tool(
+    "kaiord_get_format_spec",
+    "Get the KRD format specification. Call this before creating or editing KRD documents.",
+    {},
+    async () => formatSuccess(spec)
+  );
+};
+
 // src/tools/kaiord-inspect.ts
 import { z as z7 } from "zod";
 
@@ -695,16 +712,22 @@ var registerValidateTool = (server, logger) => {
 
 // src/server/create-server.ts
 var SERVER_NAME = "kaiord-mcp";
-var __dirname2 = dirname2(fileURLToPath(import.meta.url));
+var __dirname3 = dirname3(fileURLToPath2(import.meta.url));
 var pkg = JSON.parse(
-  readFileSync3(join(__dirname2, "../../package.json"), "utf-8")
+  readFileSync3(join(__dirname3, "../../package.json"), "utf-8")
 );
+var SERVER_INSTRUCTIONS = [
+  "Kaiord is a fitness data framework. KRD is the canonical JSON format \u2014 all conversions go through KRD.",
+  "BEFORE creating or editing KRD documents, call the kaiord_get_format_spec tool to get the full specification.",
+  "Use kaiord_list_formats to discover all supported formats (FIT, TCX, ZWO, GCN, KRD)."
+].join("\n");
 var createServer = () => {
-  const server = new McpServer({
-    name: SERVER_NAME,
-    version: pkg.version
-  });
+  const server = new McpServer(
+    { name: SERVER_NAME, version: pkg.version },
+    { instructions: SERVER_INSTRUCTIONS }
+  );
   const logger = createStderrLogger();
+  registerGetFormatSpecTool(server);
   registerListFormatsTool(server);
   registerConvertTool(server, logger);
   registerValidateTool(server, logger);

package/dist/index.js

@@ -8,8 +8,8 @@ var createStderrLogger = () => ({
 
 // src/server/create-server.ts
 import { readFileSync as readFileSync3 } from "fs";
-import { dirname as dirname2, join } from "path";
-import { fileURLToPath } from "url";
+import { dirname as dirname3, join } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/prompts/analyze-workout.ts
@@ -85,15 +85,18 @@ var registerConvertFilePrompt = (server) => {
   );
 };
 
-// src/resources/krd-format-spec.ts
+// src/utils/find-spec-file.ts
 import { existsSync, readFileSync } from "fs";
-import { resolve } from "path";
-var SPEC_URI = "kaiord://docs/krd-format";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 var DOCS_URL = "https://github.com/pablo-albaladejo/kaiord/blob/main/docs/krd-format.md";
+var __dirname2 = dirname(fileURLToPath(import.meta.url));
 var findSpecFile = () => {
   const candidates = [
     resolve(process.cwd(), "docs/krd-format.md"),
-    resolve(process.cwd(), "packages/mcp/docs/krd-format.md")
+    resolve(process.cwd(), "packages/mcp/docs/krd-format.md"),
+    resolve(__dirname2, "../../../docs/krd-format.md"),
+    resolve(__dirname2, "../../../../docs/krd-format.md")
   ];
   for (const path of candidates) {
     if (existsSync(path)) {
@@ -102,6 +105,9 @@ var findSpecFile = () => {
   }
   return `KRD format specification not found locally. See: ${DOCS_URL}`;
 };
+
+// src/resources/krd-format-spec.ts
+var SPEC_URI = "kaiord://docs/krd-format";
 var registerKrdFormatSpecResource = (server) => {
   const spec = findSpecFile();
   server.resource(
@@ -259,7 +265,7 @@ import {
   readFile as fsReadFile,
   writeFile as fsWriteFile
 } from "fs/promises";
-import { dirname } from "path";
+import { dirname as dirname2 } from "path";
 var DANGEROUS_CHARS = /[\0|;&`$(){}!\n\r]/;
 var PATH_TRAVERSAL = /(?:^|[/\\])\.\.(?:[/\\]|$)/;
 var validatePathSecurity = (inputPath) => {
@@ -293,7 +299,7 @@ var readFileAsText = async (path) => {
 };
 var writeOutputFile = async (path, data) => {
   validatePathSecurity(path);
-  await mkdir(dirname(path), { recursive: true });
+  await mkdir(dirname2(path), { recursive: true });
   if (data instanceof Uint8Array) {
     await fsWriteFile(path, data);
   } else {
@@ -573,6 +579,17 @@ var registerExtractWorkoutTool = (server, logger) => {
   );
 };
 
+// src/tools/kaiord-get-format-spec.ts
+var registerGetFormatSpecTool = (server) => {
+  const spec = findSpecFile();
+  server.tool(
+    "kaiord_get_format_spec",
+    "Get the KRD format specification. Call this before creating or editing KRD documents.",
+    {},
+    async () => formatSuccess(spec)
+  );
+};
+
 // src/tools/kaiord-inspect.ts
 import { z as z7 } from "zod";
 
@@ -690,16 +707,22 @@ var registerValidateTool = (server, logger) => {
 
 // src/server/create-server.ts
 var SERVER_NAME = "kaiord-mcp";
-var __dirname2 = dirname2(fileURLToPath(import.meta.url));
+var __dirname3 = dirname3(fileURLToPath2(import.meta.url));
 var pkg = JSON.parse(
-  readFileSync3(join(__dirname2, "../../package.json"), "utf-8")
+  readFileSync3(join(__dirname3, "../../package.json"), "utf-8")
 );
+var SERVER_INSTRUCTIONS = [
+  "Kaiord is a fitness data framework. KRD is the canonical JSON format \u2014 all conversions go through KRD.",
+  "BEFORE creating or editing KRD documents, call the kaiord_get_format_spec tool to get the full specification.",
+  "Use kaiord_list_formats to discover all supported formats (FIT, TCX, ZWO, GCN, KRD)."
+].join("\n");
 var createServer = () => {
-  const server = new McpServer({
-    name: SERVER_NAME,
-    version: pkg.version
-  });
+  const server = new McpServer(
+    { name: SERVER_NAME, version: pkg.version },
+    { instructions: SERVER_INSTRUCTIONS }
+  );
   const logger = createStderrLogger();
+  registerGetFormatSpecTool(server);
   registerListFormatsTool(server);
   registerConvertTool(server, logger);
   registerValidateTool(server, logger);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaiord/mcp",
-  "version": "4.3.2",
+  "version": "4.4.0",
   "description": "MCP server for Kaiord fitness data conversion (FIT, TCX, ZWO, GCN, KRD)",
   "type": "module",
   "bin": {
@@ -23,10 +23,10 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^4.0.0",
     "@kaiord/core": "^4.3.0",
-    "@kaiord/tcx": "^4.3.0",
-    "@kaiord/garmin": "^4.3.0",
+    "@kaiord/fit": "^4.3.0",
     "@kaiord/zwo": "^4.3.0",
-    "@kaiord/fit": "^4.3.0"
+    "@kaiord/tcx": "^4.3.0",
+    "@kaiord/garmin": "^4.3.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",