Skip to content

Commit 4435932

Browse files
committed
update migratino docs
1 parent 64ad50a commit 4435932

2 files changed

Lines changed: 12 additions & 5 deletions

File tree

docs/migration-SKILL.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,7 +480,10 @@ new McpServer(
480480
new McpServer({ name: 'server', version: '1.0.0' }, {});
481481
```
482482

483-
Access validators via `_shims` export: `import { DefaultJsonSchemaValidator } from '@modelcontextprotocol/server/_shims';`
483+
Access validators explicitly:
484+
- Runtime-aware default: `import { DefaultJsonSchemaValidator } from '@modelcontextprotocol/server/_shims';`
485+
- AJV (Node.js): `import { AjvJsonSchemaValidator } from '@modelcontextprotocol/server';`
486+
- CF Worker: `import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server/validators/cf-worker';`
484487

485488
## 15. Migration Steps (apply in this order)
486489

docs/migration.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -835,7 +835,8 @@ This means Cloudflare Workers users no longer need to explicitly pass the valida
835835
**Before (v1) - Cloudflare Workers required explicit configuration:**
836836

837837
```typescript
838-
import { McpServer, CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server';
838+
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
839+
import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/cfworker';
839840

840841
const server = new McpServer(
841842
{ name: 'my-server', version: '1.0.0' },
@@ -858,12 +859,15 @@ const server = new McpServer(
858859
);
859860
```
860861

861-
You can still explicitly override the validator if needed. The validators are available via the `_shims` export:
862+
You can still explicitly override the validator if needed:
862863

863864
```typescript
865+
// Runtime-aware default (auto-selects AjvJsonSchemaValidator or CfWorkerJsonSchemaValidator)
864866
import { DefaultJsonSchemaValidator } from '@modelcontextprotocol/server/_shims';
865-
// or
866-
import { AjvJsonSchemaValidator, CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server';
867+
868+
// Specific validators
869+
import { AjvJsonSchemaValidator } from '@modelcontextprotocol/server';
870+
import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/server/validators/cf-worker';
867871
```
868872

869873
## Unchanged APIs

0 commit comments

Comments
 (0)