@riktajs/mcp 0.1.0

package/dist/utils/zod-to-schema.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @riktajs/mcp - Zod to JSON Schema Conversion
+ *
+ * Utilities for converting Zod schemas to JSON Schema format
+ * compatible with @platformatic/mcp.
+ */
+import type { ZodType, ZodTypeDef } from 'zod';
+import { type JsonSchema7Type } from 'zod-to-json-schema';
+/**
+ * Type guard to check if a value is a Zod schema
+ * Uses duck typing to detect Zod schemas without requiring the full library
+ */
+export declare function isZodSchema(value: unknown): value is ZodType<unknown, ZodTypeDef, unknown>;
+/**
+ * Convert a Zod schema to JSON Schema format for MCP
+ *
+ * @param schema - The Zod schema to convert
+ * @returns JSON Schema object compatible with MCP
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *   path: z.string().describe('File path'),
+ *   encoding: z.string().optional(),
+ * });
+ *
+ * const jsonSchema = zodToMCPSchema(schema);
+ * // {
+ * //   type: 'object',
+ * //   properties: {
+ * //     path: { type: 'string', description: 'File path' },
+ * //     encoding: { type: 'string' }
+ * //   },
+ * //   required: ['path']
+ * // }
+ * ```
+ */
+export declare function zodToMCPSchema(schema: ZodType): JsonSchema7Type;
+/**
+ * Convert a Zod schema to JSON Schema, or return undefined if not a Zod schema
+ *
+ * @param schemaOrUndefined - The Zod schema or undefined
+ * @returns JSON Schema object or undefined
+ */
+export declare function toMCPSchema(schemaOrUndefined: ZodType | undefined): JsonSchema7Type | undefined;
+//# sourceMappingURL=zod-to-schema.d.ts.map

package/dist/utils/zod-to-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-schema.d.ts","sourceRoot":"","sources":["../../src/utils/zod-to-schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAC/C,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAQ1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAc/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,iBAAiB,EAAE,OAAO,GAAG,SAAS,GACrC,eAAe,GAAG,SAAS,CAU7B"}

package/dist/utils/zod-to-schema.js

@@ -0,0 +1,67 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Type guard to check if a value is a Zod schema
+ * Uses duck typing to detect Zod schemas without requiring the full library
+ */
+export function isZodSchema(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        '_def' in value &&
+        'safeParse' in value &&
+        typeof value.safeParse === 'function');
+}
+/**
+ * Convert a Zod schema to JSON Schema format for MCP
+ *
+ * @param schema - The Zod schema to convert
+ * @returns JSON Schema object compatible with MCP
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *   path: z.string().describe('File path'),
+ *   encoding: z.string().optional(),
+ * });
+ *
+ * const jsonSchema = zodToMCPSchema(schema);
+ * // {
+ * //   type: 'object',
+ * //   properties: {
+ * //     path: { type: 'string', description: 'File path' },
+ * //     encoding: { type: 'string' }
+ * //   },
+ * //   required: ['path']
+ * // }
+ * ```
+ */
+export function zodToMCPSchema(schema) {
+    const jsonSchema = zodToJsonSchema(schema, {
+        target: 'jsonSchema7',
+        $refStrategy: 'none', // Inline all references
+    });
+    // Remove $schema property as MCP doesn't need it
+    if (typeof jsonSchema === 'object' && jsonSchema !== null) {
+        const result = { ...jsonSchema };
+        delete result.$schema;
+        return result;
+    }
+    return jsonSchema;
+}
+/**
+ * Convert a Zod schema to JSON Schema, or return undefined if not a Zod schema
+ *
+ * @param schemaOrUndefined - The Zod schema or undefined
+ * @returns JSON Schema object or undefined
+ */
+export function toMCPSchema(schemaOrUndefined) {
+    if (!schemaOrUndefined) {
+        return undefined;
+    }
+    if (isZodSchema(schemaOrUndefined)) {
+        return zodToMCPSchema(schemaOrUndefined);
+    }
+    return undefined;
+}
+//# sourceMappingURL=zod-to-schema.js.map

package/dist/utils/zod-to-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-schema.js","sourceRoot":"","sources":["../../src/utils/zod-to-schema.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAgC,CAAC,SAAS,KAAK,UAAU,CAClE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE;QACzC,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,MAAM,EAAE,wBAAwB;KAC/C,CAAC,CAAC;IAEH,iDAAiD;IACjD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,EAA6B,CAAC;QAC5D,OAAO,MAAM,CAAC,OAAO,CAAC;QACtB,OAAO,MAAyB,CAAC;IACnC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,iBAAsC;IAEtC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,WAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@riktajs/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) integration for Rikta Framework - Connect AI assistants to your backend",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "rikta",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "fastify",
+    "typescript",
+    "decorators",
+    "tools",
+    "resources",
+    "prompts"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "@riktajs/core": ">=0.4.3",
+    "fastify": ">=5.0.0",
+    "reflect-metadata": ">=0.2.0",
+    "zod": ">=3.20.0"
+  },
+  "dependencies": {
+    "@platformatic/mcp": "^1.0.0",
+    "fastify-plugin": "^5.0.1",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "devDependencies": {
+    "@riktajs/core": "*",
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.9",
+    "fastify": "^5.3.2",
+    "reflect-metadata": "^0.2.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "zod": "^3.25.76"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/riktahq/rikta.git",
+    "directory": "packages/mcp"
+  }
+}