@2kw/ai-mcp-server 6.1.0-dev.8 → 6.2.0-dev.13

package/dist/tools/skills.js

@@ -0,0 +1,177 @@
+import { z } from "zod";
+import { readFile, stat } from "node:fs/promises";
+import { basename, extname } from "node:path";
+import { BackboneApiError, formatErrorForMcp } from "../errors.js";
+// Spring accepts flat pagination parameters despite the generated pageable wrapper.
+function paginationParams(params) {
+    return {
+        page: params.page ?? 0,
+        size: params.size ?? 20,
+        sort: params.sort ? [params.sort] : undefined,
+    };
+}
+/** Register skill read and import tools (#642). */
+export function register(server, client) {
+    server.tool("2kw_list_skills", "List org skills with optional name/status filter and pagination.", {
+        search: z.string().optional().describe("Filter by name"),
+        status: z.enum(["ACTIVE", "ARCHIVED"]).optional(),
+        page: z.number().int().min(0).optional(),
+        size: z.number().int().min(1).max(100).optional(),
+        sort: z.string().optional().describe("Sort field and direction"),
+    }, async (params) => {
+        try {
+            const { data } = await client.GET("/v1/skills", {
+                params: {
+                    query: {
+                        search: params.search,
+                        status: params.status,
+                        ...paginationParams(params),
+                    },
+                },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_get_skill", "Get a skill by ID, including its latest version number.", { skillId: z.string() }, async (params) => {
+        try {
+            const { data } = await client.GET("/v1/skills/{id}", {
+                params: { path: { id: params.skillId } },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_list_skill_versions", "List versions of a skill with pagination.", {
+        skillId: z.string(),
+        page: z.number().int().min(0).optional(),
+        size: z.number().int().min(1).max(100).optional(),
+        sort: z.string().optional().describe("Sort field and direction"),
+    }, async (params) => {
+        try {
+            const { data } = await client.GET("/v1/skills/{id}/versions", {
+                params: {
+                    path: { id: params.skillId },
+                    query: paginationParams(params),
+                },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_get_skill_version", "Get a skill version, including description, body, frontmatter and resources.", {
+        skillId: z.string(),
+        versionNumber: z.number().int().min(1),
+    }, async (params) => {
+        try {
+            const { data } = await client.GET("/v1/skills/{id}/versions/{versionNumber}", {
+                params: { path: { id: params.skillId, versionNumber: params.versionNumber } },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_list_skill_labels", "List skill labels and the versions they point to.", { skillId: z.string() }, async (params) => {
+        try {
+            const { data } = await client.GET("/v1/skills/{id}/labels", {
+                params: { path: { id: params.skillId } },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_resolve_skill", "Resolve a skill by name, name@label or name@version number.", { ref: z.string().min(1).describe("Skill reference: name, name@label or name@<n>") }, async (params) => {
+        try {
+            const { data } = await client.GET("/v1/skills/resolve", {
+                params: { query: { ref: params.ref } },
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("2kw_import_skill", "Import a local SKILL.md or .zip file. Returns outcome, version, renamedFrom and skipped files. Zip directories before importing.", { filePath: z.string().min(1).describe("Local path to SKILL.md or a .zip archive") }, async (params) => {
+        try {
+            const info = await stat(params.filePath);
+            if (info.isDirectory())
+                throw new Error("Cannot import a directory; zip it first.");
+            const filename = basename(params.filePath);
+            const isZip = extname(filename).toLowerCase() === ".zip";
+            if (filename !== "SKILL.md" && !isZip) {
+                throw new Error("Import requires a SKILL.md or .zip file.");
+            }
+            const buffer = await readFile(params.filePath);
+            const formData = new FormData();
+            formData.append("file", new Blob([buffer], {
+                type: isZip ? "application/zip" : "text/markdown",
+            }), filename);
+            const { baseUrl, apiKey } = client._config;
+            const res = await fetch(`${baseUrl.replace(/\/+$/, "")}/v1/skills/import`, {
+                method: "POST",
+                headers: { Authorization: `Bearer ${apiKey}` },
+                body: formData,
+            });
+            if (!res.ok) {
+                const body = await res.json().catch(() => ({}));
+                throw new BackboneApiError({
+                    status: body.status ?? res.status,
+                    error: body.title ?? body.error ?? res.statusText,
+                    message: body.detail ?? body.message ?? `HTTP ${res.status}: ${res.statusText}`,
+                    timestamp: body.timestamp ?? new Date().toISOString(),
+                });
+            }
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: formatErrorForMcp(error) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=skills.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@2kw/ai-mcp-server",
-  "version": "6.1.0-dev.8",
-  "description": "MCP server for 2kw.ai — EU-hosted AI platform: OpenAI-compatible LLM gateway, schema-driven document extraction, transcription, and cost observability. 88 tools for Claude Code, Cursor, and Windsurf.",
+  "version": "6.2.0-dev.13",
+  "description": "MCP server for 2kw.ai — EU-hosted AI platform: OpenAI-compatible LLM gateway, schema-driven document extraction, transcription, agents with a knowledge base, and cost observability. 158 tools for Claude Code, Cursor, and Windsurf.",
   "mcpName": "ai.2kw/mcp-server",
   "keywords": [
     "mcp",
@@ -48,7 +48,7 @@
     "openapi-fetch": "^0.13.5"
   },
   "devDependencies": {
-    "@types/node": "^22.19.17",
+    "@types/node": "^22.20.1",
     "openapi-typescript": "^7.13.0",
     "tsx": "^4.21.1",
     "typescript": "^5.9.3"