fix(packaging): inline json-schema-typed in dist .d.mts; move validator-provider types to subpath-only; drop dead typesVersions.sse

.changeset/validators-subpath-only.md

@@ -0,0 +1,6 @@
+---
+'@modelcontextprotocol/server': patch
+'@modelcontextprotocol/client': patch
+---
+
+`AjvJsonSchemaValidator`, `CfWorkerJsonSchemaValidator` and `CfWorkerSchemaDraft` types are now only exported from the `/validators/ajv` and `/validators/cf-worker` subpaths, not the package root. The codemod already routes v1 imports there.

packages/client/README.md

@@ -16,6 +16,8 @@ The MCP (Model Context Protocol) TypeScript client SDK. Build MCP clients that c
 npm install @modelcontextprotocol/client@alpha
 ```
 
+TypeScript ≥6.0 no longer auto-includes `@types/*` — add `"types": ["node"]` to your `tsconfig.json` `compilerOptions` (the published `.d.mts` references `Buffer`).
+
 ## Documentation
 
 - **[Repository README](https://github.com/modelcontextprotocol/typescript-sdk#readme)** — overview, package layout, examples

packages/client/tsdown.config.ts

@@ -20,10 +20,11 @@ export default defineConfig({
     shims: true,
     dts: {
         resolver: 'tsc',
-        resolve: ['ajv', 'ajv-formats'],
+        resolve: ['ajv', 'ajv-formats', 'json-schema-typed'],
         compilerOptions: {
             baseUrl: '.',
             paths: {
+                'fast-uri': ['../core/src/validators/fastUriShim.d.ts'],
                 '@modelcontextprotocol/core': ['../core/src/index.ts'],
                 '@modelcontextprotocol/core/public': ['../core/src/exports/public/index.ts'],
                 '@modelcontextprotocol/core/validators/ajv': ['../core/src/validators/ajvProvider.ts'],

packages/core/src/exports/public/index.ts

@@ -129,10 +129,10 @@ export {
 export type { SpecTypeName, SpecTypes } from '../../types/specTypeSchema.js';
 export { isSpecType, specTypeSchemas } from '../../types/specTypeSchema.js';
 export type { StandardSchemaV1, StandardSchemaV1Sync, StandardSchemaWithJSON } from '../../util/standardSchema.js';
-// Validator providers are type-only here — import the runtime classes from the explicit
-// `@modelcontextprotocol/{client,server}/validators/{ajv,cf-worker}` subpaths to customise.
-export type { AjvJsonSchemaValidator } from '../../validators/ajvProvider.js';
-export type { CfWorkerJsonSchemaValidator, CfWorkerSchemaDraft } from '../../validators/cfWorkerProvider.js';
+// Validator provider classes (`AjvJsonSchemaValidator`, `CfWorkerJsonSchemaValidator`) are
+// intentionally NOT re-exported here — import them from the explicit
+// `@modelcontextprotocol/{client,server}/validators/{ajv,cf-worker}` subpaths so the
+// root entrypoint's bundled `.d.mts` doesn't pull the inlined ajv/cfworker type chunks.
 // fromJsonSchema is intentionally NOT exported here — the server and client packages
 // provide runtime-aware wrappers that default to the appropriate validator via _shims.
 export type { JsonSchemaType, JsonSchemaValidator, jsonSchemaValidator, JsonSchemaValidatorResult } from '../../validators/types.js';

packages/core/src/validators/fastUriShim.d.ts

@@ -0,0 +1,24 @@
+/**
+ * dts-bundling shim for `fast-uri`.
+ *
+ * ajv@8.18.0's published .d.ts does `import { URIComponent } from "fast-uri"`,
+ * but fast-uri ships its types as `export = namespace`, which rolldown's dts
+ * bundler can't destructure into a named import — it drops the import and
+ * leaves a dangling `URIComponent` reference in the bundled .d.mts (TS2304 for
+ * downstream consumers with `skipLibCheck: false`).
+ *
+ * The server/client tsdown configs map `fast-uri` to this file via
+ * `dts.compilerOptions.paths` so the type is inlined as a plain named export.
+ * Runtime code is unaffected (this is a `.d.ts`; the path mapping is dts-only).
+ */
+export interface URIComponent {
+    scheme?: string;
+    userinfo?: string;
+    host?: string;
+    port?: number | string;
+    path?: string;
+    query?: string;
+    fragment?: string;
+    reference?: string;
+    error?: string;
+}

packages/middleware/node/package.json

@@ -27,13 +27,6 @@
         }
     },
     "types": "./dist/index.d.mts",
-    "typesVersions": {
-        "*": {
-            "sse": [
-                "dist/sse.d.mts"
-            ]
-        }
-    },
     "files": [
         "dist"
     ],

packages/server/README.md

@@ -16,6 +16,8 @@ The MCP (Model Context Protocol) TypeScript server SDK. Build MCP servers that e
 npm install @modelcontextprotocol/server@alpha
 ```
 
+TypeScript ≥6.0 no longer auto-includes `@types/*` — add `"types": ["node"]` to your `tsconfig.json` `compilerOptions` (the published `.d.mts` references `Buffer`).
+
 Optional framework adapters: [`@modelcontextprotocol/express`](https://www.npmjs.com/package/@modelcontextprotocol/express), [`@modelcontextprotocol/hono`](https://www.npmjs.com/package/@modelcontextprotocol/hono),
 [`@modelcontextprotocol/node`](https://www.npmjs.com/package/@modelcontextprotocol/node).
 

packages/server/tsdown.config.ts

@@ -19,10 +19,11 @@ export default defineConfig({
     shims: true,
     dts: {
         resolver: 'tsc',
-        resolve: ['ajv', 'ajv-formats'],
+        resolve: ['ajv', 'ajv-formats', 'json-schema-typed'],
         compilerOptions: {
             baseUrl: '.',
             paths: {
+                'fast-uri': ['../core/src/validators/fastUriShim.d.ts'],
                 '@modelcontextprotocol/core': ['../core/src/index.ts'],
                 '@modelcontextprotocol/core/public': ['../core/src/exports/public/index.ts'],
                 '@modelcontextprotocol/core/validators/ajv': ['../core/src/validators/ajvProvider.ts'],