@kavo/mcp 0.7.0

package/dist/discovery.d.ts

@@ -0,0 +1,36 @@
+import type { ClassRef, EntityId } from "@kavo/core";
+import type { BoundKavoService, KavoMcpToolBinding } from "./tools.js";
+/** The minimum a host framework needs to hand this package about one `@Kavo` entity. */
+export interface KavoEntityRef {
+    readonly entity: ClassRef;
+}
+/**
+ * The host-agnostic half of "collect every entity's standard toolset into
+ * one process-wide MCP toolset." One thing stays deliberately outside this
+ * package, supplied by the caller instead — the same split
+ * `@kavo/graphql`'s `resolveKavoGraphQLSchema` uses for its own "how to
+ * resolve a service" half:
+ *
+ * - **How to resolve a bound service for one entity** — `@kavo/nest`'s
+ *   `ModuleRef` + `getKavoServiceToken`, a plain `Map`, or whatever DI
+ *   container that host uses.
+ *
+ * Every entity in `entities` gets the full standard toolset unconditionally
+ * (`crudTools`, no per-entity opt-in) — the list of entities to expose is
+ * controlled entirely by what the caller passes in (e.g. `@kavo/nest`'s
+ * `getKavoEntities()`, every `@Kavo`-decorated class), not by a second,
+ * MCP-specific registry.
+ *
+ * This function only ever touches `@kavo/core` shapes — never a host
+ * framework — so the same call works from a Nest MCP controller today and
+ * from a future `@kavo/express`/`@kavo/fastify`/`@kavo/nextjs` binding
+ * without either package importing the other (ADR-0016's `protocols/*`
+ * shape).
+ *
+ * Unlike `mergeKavoGraphQLSchemas` (which must fail fast on an empty
+ * `Query` type — GraphQL has no such thing as a schema with zero fields),
+ * an empty tool list is a perfectly valid MCP `ListToolsResult`, so an
+ * empty `entities` list is not treated as an error here.
+ */
+export declare function resolveKavoMcpTools(entities: readonly KavoEntityRef[], resolveService: (entity: ClassRef) => BoundKavoService<object, EntityId, unknown, unknown, unknown>): readonly KavoMcpToolBinding[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGvE,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,GAClG,SAAS,kBAAkB,EAAE,CAQ/B"}

package/dist/discovery.js

@@ -0,0 +1,37 @@
+import { crudTools } from "./tools.js";
+/**
+ * The host-agnostic half of "collect every entity's standard toolset into
+ * one process-wide MCP toolset." One thing stays deliberately outside this
+ * package, supplied by the caller instead — the same split
+ * `@kavo/graphql`'s `resolveKavoGraphQLSchema` uses for its own "how to
+ * resolve a service" half:
+ *
+ * - **How to resolve a bound service for one entity** — `@kavo/nest`'s
+ *   `ModuleRef` + `getKavoServiceToken`, a plain `Map`, or whatever DI
+ *   container that host uses.
+ *
+ * Every entity in `entities` gets the full standard toolset unconditionally
+ * (`crudTools`, no per-entity opt-in) — the list of entities to expose is
+ * controlled entirely by what the caller passes in (e.g. `@kavo/nest`'s
+ * `getKavoEntities()`, every `@Kavo`-decorated class), not by a second,
+ * MCP-specific registry.
+ *
+ * This function only ever touches `@kavo/core` shapes — never a host
+ * framework — so the same call works from a Nest MCP controller today and
+ * from a future `@kavo/express`/`@kavo/fastify`/`@kavo/nextjs` binding
+ * without either package importing the other (ADR-0016's `protocols/*`
+ * shape).
+ *
+ * Unlike `mergeKavoGraphQLSchemas` (which must fail fast on an empty
+ * `Query` type — GraphQL has no such thing as a schema with zero fields),
+ * an empty tool list is a perfectly valid MCP `ListToolsResult`, so an
+ * empty `entities` list is not treated as an error here.
+ */
+export function resolveKavoMcpTools(entities, resolveService) {
+    const bindings = [];
+    for (const { entity } of entities) {
+        bindings.push(...crudTools({ name: entity.name, service: resolveService(entity) }));
+    }
+    return bindings;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOvC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkC,EAClC,cAAmG;IAEnG,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { crudTools, type KavoMcpToolsOptions, type KavoMcpToolBinding, type BoundKavoService } from "./tools.js";
+export { resolveKavoMcpTools, type KavoEntityRef } from "./discovery.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjH,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { crudTools } from "./tools.js";
+export { resolveKavoMcpTools } from "./discovery.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA4E,MAAM,YAAY,CAAC;AACjH,OAAO,EAAE,mBAAmB,EAAsB,MAAM,gBAAgB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,35 @@
+import type { CallToolResult, Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { DefaultKavoService, EntityId } from "@kavo/core";
+/**
+ * What a tool handler in this binding actually calls — the same
+ * transport-agnostic programmatic surface `createCrud` returns that
+ * `@kavo/graphql`'s `BoundKavoService` binds to. Kept as its own structural
+ * type for the same reason: a caller only has to satisfy the operations a
+ * toolset actually wires up.
+ */
+export type BoundKavoService<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto> = Pick<DefaultKavoService<Entity, Id, CreateDto, UpdateDto, PatchDto, unknown, unknown, unknown>, "findOne" | "findMany" | "createOne" | "updateOne" | "patchOne" | "deleteOne" | "restoreOne" | "purgeOne">;
+/** One entity's MCP tool binding: a `Tool` definition plus the handler that runs it — `crudTools`'s unit of work. */
+export interface KavoMcpToolBinding {
+    readonly tool: Tool;
+    readonly handler: (args: Record<string, unknown>) => Promise<CallToolResult>;
+}
+/** One entity's MCP binding options. */
+export interface KavoMcpToolsOptions<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto> {
+    /** Singular, capitalized entity name — becomes the `<lowerName>.<operation>` tool name prefix. */
+    readonly name: string;
+    readonly service: BoundKavoService<Entity, Id, CreateDto, UpdateDto, PatchDto>;
+}
+/**
+ * Every standard operation, for one entity — unconditional. There is no
+ * per-entity opt-in or hand-authored input schema (there used to be; see
+ * git history / the issue this simplified) — every `@Kavo` entity handed
+ * to `resolveKavoMcpTools` gets the full 8-tool set, the same way `@Kavo`
+ * itself enables every standard operation by default. An operation that
+ * doesn't actually apply — `restoreOne` on a non-soft-deletable entity, or
+ * any operation an entity's own `@Kavo` config disabled — still produces a
+ * tool, and calling it surfaces `OperationDisabledException` as a normal
+ * `isError` result (`guarded`), exactly like calling the disabled REST
+ * route would.
+ */
+export declare function crudTools<Entity extends object, Id extends EntityId, CreateDto, UpdateDto, PatchDto>(options: KavoMcpToolsOptions<Entity, Id, CreateDto, UpdateDto, PatchDto>): readonly KavoMcpToolBinding[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiB/D;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,MAAM,EAAE,EAAE,SAAS,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,IAAI,IAAI,CAC7G,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EACzF,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAC1G,CAAC;AAyCF,qHAAqH;AACrH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9E;AAED,wCAAwC;AACxC,MAAM,WAAW,mBAAmB,CAAC,MAAM,SAAS,MAAM,EAAE,EAAE,SAAS,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ;IAC7G,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;CAChF;AAyDD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,MAAM,EAAE,EAAE,SAAS,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAClG,OAAO,EAAE,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,GACvE,SAAS,kBAAkB,EAAE,CAyF/B"}

package/dist/tools.js

@@ -0,0 +1,189 @@
+import { ConfigurationException, KavoException } from "@kavo/core";
+/**
+ * `sort: ["-createdAt", "name"]` → `[{ field: "createdAt", direction: "desc" }, { field: "name", direction: "asc" }]`
+ * — same convention (and same reasoning) as `@kavo/graphql`'s `parseSortArg`: this binding calls the programmatic
+ * `QueryContext` surface directly, never REST's wire-string parser.
+ */
+function parseSortArg(tokens) {
+    if (tokens === undefined)
+        return [];
+    return tokens.map((token) => token.startsWith("-")
+        ? { field: token.slice(1), direction: "desc" }
+        : { field: token, direction: "asc" });
+}
+/**
+ * Refuse to bind an entity this protocol cannot page (ADR-0021 §7, extended
+ * to `since` by ADR-0022).
+ *
+ * `<name>.findMany` accepts `limit`/`offset` only, and `QueryNormalizer`
+ * ignores `offset` under both keyset strategies — so a model calling
+ * `todo.findMany({ limit: 20, offset: 40 })` against a cursor- or
+ * since-configured entity gets rows 1–20 (or everything from the beginning)
+ * back with no error and no way to tell, and the `nextCursor`/`nextSince` it
+ * would need is not in the tool's result shape. Name-gated on
+ * `"cursor"`/`"since"` rather than structural, the same limitation
+ * ADR-0021 §7 already records. Failing at bootstrap beats answering wrongly.
+ * `@kavo/graphql` carries the identical guard; the two packages may not
+ * import each other, so it is duplicated rather than shared.
+ */
+/**
+ * The bound entity's configured `pagination.strategy`, read structurally —
+ * for the same reason `@kavo/graphql` reads it that way: putting `engine` in
+ * `BoundKavoService`'s `Pick` would drag the entity-typed
+ * `ResolvedEntityConfig` into an invariant position and break every erased
+ * `BoundKavoService<object, …>` call site.
+ */
+function paginationStrategyOf(service) {
+    const engine = service.engine;
+    return engine?.config?.settings?.pagination?.strategy;
+}
+function requireOffsetPageable(entityName, strategy) {
+    if (strategy !== "cursor" && strategy !== "since")
+        return;
+    throw new ConfigurationException(entityName, "pagination.strategy", `'${strategy}' is not supported by the MCP binding: '<entity>.findMany' exposes 'limit'/'offset' only, ` +
+        `and a keyset page ignores 'offset' — a paged call would silently return the first page (or everything ` +
+        `from the beginning) every time. Either page this entity over REST, or give it an entity-scope ` +
+        `'pagination.strategy' of 'offset'/'page'`);
+}
+function lowerFirst(value) {
+    return value.charAt(0).toLowerCase() + value.slice(1);
+}
+function textResult(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value) }] };
+}
+/**
+ * Runs a handler and turns a `KavoException` into a normal (`isError:
+ * true`) tool result instead of letting it propagate — the MCP protocol's
+ * own convention for an expected domain failure (bad id, disabled
+ * operation, conflict): the *call* succeeded, the *operation* didn't. An
+ * error the engine did not itself raise (a bug, an unmapped adapter
+ * failure) still propagates, so it surfaces as a protocol-level error
+ * rather than being silently reframed as routine tool output.
+ *
+ * This is also how a mutation tool that doesn't apply to a given entity —
+ * `restoreOne`/`purgeOne` on one that never declared soft delete —
+ * degrades: every entity gets the full standard toolset unconditionally
+ * (§ below), and the engine's own `OperationDisabledException` for a
+ * disabled operation lands here as a normal `isError` result, exactly the
+ * way calling the equivalent disabled REST route would.
+ */
+async function guarded(fn) {
+    try {
+        return textResult(await fn());
+    }
+    catch (error) {
+        if (error instanceof KavoException) {
+            return { isError: true, content: [{ type: "text", text: `${error.code}: ${error.detail}` }] };
+        }
+        throw error;
+    }
+}
+const idSchema = { type: ["string", "number"] };
+function objectSchema(properties, required) {
+    return { type: "object", properties, required: [...required] };
+}
+const idOnlySchema = objectSchema({ id: idSchema }, ["id"]);
+/**
+ * `{ id }` required, with any other property left unconstrained — JSON
+ * Schema permits additional properties by default (no `additionalProperties:
+ * false` here), so this doubles as `updateOne`/`patchOne`'s input schema: a
+ * caller fills in `id` plus whatever DTO fields it wants, with no
+ * per-entity schema to author or keep in sync.
+ */
+const idAndFreeformSchema = objectSchema({ id: idSchema }, ["id"]);
+/** No constraints at all — every field an entity's `create` DTO accepts, forwarded straight through. */
+const freeformObjectSchema = { type: "object" };
+/**
+ * Every standard operation, for one entity — unconditional. There is no
+ * per-entity opt-in or hand-authored input schema (there used to be; see
+ * git history / the issue this simplified) — every `@Kavo` entity handed
+ * to `resolveKavoMcpTools` gets the full 8-tool set, the same way `@Kavo`
+ * itself enables every standard operation by default. An operation that
+ * doesn't actually apply — `restoreOne` on a non-soft-deletable entity, or
+ * any operation an entity's own `@Kavo` config disabled — still produces a
+ * tool, and calling it surfaces `OperationDisabledException` as a normal
+ * `isError` result (`guarded`), exactly like calling the disabled REST
+ * route would.
+ */
+export function crudTools(options) {
+    const { name, service } = options;
+    requireOffsetPageable(name, paginationStrategyOf(service));
+    const prefix = lowerFirst(name);
+    return [
+        {
+            tool: { name: `${prefix}.findOne`, description: `Find one ${name} by id.`, inputSchema: idOnlySchema },
+            handler: (args) => guarded(() => service.findOne(args["id"])),
+        },
+        {
+            tool: {
+                name: `${prefix}.findMany`,
+                description: `List ${name} records, with optional pagination, sort, and filter.`,
+                inputSchema: objectSchema({
+                    limit: { type: "integer" },
+                    offset: { type: "integer" },
+                    sort: { type: "array", items: { type: "string" } },
+                    filter: { type: "object" },
+                }, []),
+            },
+            handler: (args) => guarded(() => service.findMany({
+                limit: args["limit"],
+                offset: args["offset"],
+                sort: parseSortArg(args["sort"]),
+                filter: args["filter"] ?? null,
+            })),
+        },
+        {
+            tool: { name: `${prefix}.createOne`, description: `Create a new ${name}.`, inputSchema: freeformObjectSchema },
+            handler: (args) => guarded(() => service.createOne(args)),
+        },
+        {
+            tool: {
+                name: `${prefix}.updateOne`,
+                description: `Replace an existing ${name} by id.`,
+                inputSchema: idAndFreeformSchema,
+            },
+            handler: (args) => {
+                const { id, ...input } = args;
+                return guarded(() => service.updateOne(id, input));
+            },
+        },
+        {
+            tool: {
+                name: `${prefix}.patchOne`,
+                description: `Partially update an existing ${name} by id.`,
+                inputSchema: idAndFreeformSchema,
+            },
+            handler: (args) => {
+                const { id, ...input } = args;
+                return guarded(() => service.patchOne(id, input));
+            },
+        },
+        {
+            tool: { name: `${prefix}.deleteOne`, description: `Delete a ${name} by id.`, inputSchema: idOnlySchema },
+            handler: (args) => guarded(async () => {
+                await service.deleteOne(args["id"]);
+                return { deleted: true };
+            }),
+        },
+        {
+            tool: {
+                name: `${prefix}.restoreOne`,
+                description: `Restore a soft-deleted ${name} by id.`,
+                inputSchema: idOnlySchema,
+            },
+            handler: (args) => guarded(() => service.restoreOne(args["id"])),
+        },
+        {
+            tool: {
+                name: `${prefix}.purgeOne`,
+                description: `Permanently delete a soft-deleted ${name} by id.`,
+                inputSchema: idOnlySchema,
+            },
+            handler: (args) => guarded(async () => {
+                await service.purgeOne(args["id"]);
+                return { purged: true };
+            }),
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kavo/mcp",
+  "version": "0.7.0",
+  "description": "Kavo MCP binding — exposes a createCrud service's standard operations as MCP tools, delegating every call to the same engine REST uses.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kavo-labs/kavo.git",
+    "directory": "packages/protocols/mcp"
+  },
+  "homepage": "https://github.com/kavo-labs/kavo/tree/main/packages/protocols/mcp#readme",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kavo/core": "workspace:^"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}