@modelcontextprotocol/sdk 1.20.1 → 1.21.0

package/dist/esm/validation/index.js

@@ -0,0 +1,29 @@
+/**
+ * JSON Schema validation
+ *
+ * This module provides configurable JSON Schema validation for the MCP SDK.
+ * Choose a validator based on your runtime environment:
+ *
+ * - AjvJsonSchemaValidator: Best for Node.js (default, fastest)
+ *   Import from: @modelcontextprotocol/sdk/validation/ajv
+ *   Requires peer dependencies: ajv, ajv-formats
+ *
+ * - CfWorkerJsonSchemaValidator: Best for edge runtimes
+ *   Import from: @modelcontextprotocol/sdk/validation/cfworker
+ *   Requires peer dependency: @cfworker/json-schema
+ *
+ * @example
+ * ```typescript
+ * // For Node.js with AJV
+ * import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+ * const validator = new AjvJsonSchemaValidator();
+ *
+ * // For Cloudflare Workers
+ * import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/cfworker';
+ * const validator = new CfWorkerJsonSchemaValidator();
+ * ```
+ *
+ * @module validation
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/esm/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/esm/validation/types.d.ts

@@ -0,0 +1,55 @@
+import type { Schema } from '@cfworker/json-schema';
+/**
+ * Result of a JSON Schema validation operation
+ */
+export type JsonSchemaValidatorResult<T> = {
+    valid: true;
+    data: T;
+    errorMessage: undefined;
+} | {
+    valid: false;
+    data: undefined;
+    errorMessage: string;
+};
+/**
+ * A validator function that validates data against a JSON Schema
+ */
+export type JsonSchemaValidator<T> = (input: unknown) => JsonSchemaValidatorResult<T>;
+/**
+ * Provider interface for creating validators from JSON Schemas
+ *
+ * This is the main extension point for custom validator implementations.
+ * Implementations should:
+ * - Support JSON Schema Draft 2020-12 (or be compatible with it)
+ * - Return validator functions that can be called multiple times
+ * - Handle schema compilation/caching internally
+ * - Provide clear error messages on validation failure
+ *
+ * @example
+ * ```typescript
+ * class MyValidatorProvider implements jsonSchemaValidator {
+ *   getValidator<T>(schema: JsonSchemaType<T>): JsonSchemaValidator<T> {
+ *     // Compile/cache validator from schema
+ *     return (input: unknown) => {
+ *       // Validate input against schema
+ *       if (valid) {
+ *         return { valid: true, data: input as T, errorMessage: undefined };
+ *       } else {
+ *         return { valid: false, data: undefined, errorMessage: 'Error details' };
+ *       }
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface jsonSchemaValidator {
+    /**
+     * Create a validator for the given JSON Schema
+     *
+     * @param schema - Standard JSON Schema object
+     * @returns A validator function that can be called multiple times
+     */
+    getValidator<T>(schema: JsonSchemaType): JsonSchemaValidator<T>;
+}
+export type JsonSchemaType = Schema;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/validation/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/validation/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACjC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,YAAY,EAAE,SAAS,CAAA;CAAE,GACjD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;;OAKG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC"}

package/dist/esm/validation/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/validation/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@modelcontextprotocol/sdk",
-    "version": "1.20.1",
+    "version": "1.21.0",
     "description": "Model Context Protocol implementation for TypeScript",
     "license": "MIT",
     "author": "Anthropic, PBC (https://anthropic.com)",
@@ -31,6 +31,18 @@
             "import": "./dist/esm/server/index.js",
             "require": "./dist/cjs/server/index.js"
         },
+        "./validation": {
+            "import": "./dist/esm/validation/index.js",
+            "require": "./dist/cjs/validation/index.js"
+        },
+        "./validation/ajv": {
+            "import": "./dist/esm/validation/ajv-provider.js",
+            "require": "./dist/cjs/validation/ajv-provider.js"
+        },
+        "./validation/cfworker": {
+            "import": "./dist/esm/validation/cfworker-provider.js",
+            "require": "./dist/cjs/validation/cfworker-provider.js"
+        },
         "./*": {
             "import": "./dist/esm/*",
             "require": "./dist/cjs/*"
@@ -63,7 +75,8 @@
         "client": "tsx src/cli.ts client"
     },
     "dependencies": {
-        "ajv": "^6.12.6",
+        "ajv": "^8.17.1",
+        "ajv-formats": "^3.0.1",
         "content-type": "^1.0.5",
         "cors": "^2.8.5",
         "cross-spawn": "^7.0.5",
@@ -76,7 +89,16 @@
         "zod": "^3.23.8",
         "zod-to-json-schema": "^3.24.1"
     },
+    "peerDependencies": {
+        "@cfworker/json-schema": "^4.1.1"
+    },
+    "peerDependenciesMeta": {
+        "@cfworker/json-schema": {
+            "optional": true
+        }
+    },
     "devDependencies": {
+        "@cfworker/json-schema": "^4.1.1",
         "@eslint/js": "^9.8.0",
         "@jest-mock/express": "^3.0.0",
         "@types/content-type": "^1.1.8",
@@ -91,8 +113,8 @@
         "@types/ws": "^8.5.12",
         "eslint": "^9.8.0",
         "eslint-config-prettier": "^10.1.8",
-        "prettier": "3.6.2",
         "jest": "^29.7.0",
+        "prettier": "3.6.2",
         "supertest": "^7.0.0",
         "ts-jest": "^29.2.4",
         "tsx": "^4.16.5",