feat: MCP v2 (draft)

[KKonstantinov]

Migrate the TypeScript reference servers (everything, filesystem, sequentialthinking) to the v2 MCP TypeScript SDK.

Note

Do not merge this. Goal of PR is to remain open and be updated through beta, stable. See Roadmap section below.

Roadmap

• Initial alpha draft
• Review // @mcp-codemod-error comments
• Update to beta (legacy era MCP on modern interfaces)
• Update to stable - backwards compatible with legacy era MCP clients; enabling Modern stateless MCP will need maintainers support

Description

Migrates the TypeScript reference servers — everything, filesystem, and sequentialthinking — from the v1 monolithic SDK (@modelcontextprotocol/sdk@^1.29.0) to the v2 scoped packages (@modelcontextprotocol/server, @modelcontextprotocol/node, @modelcontextprotocol/core; 2.0.0-alpha.3). The Python servers are untouched.

The bulk of the migration was produced automatically by the SDK's v1-to-v2 codemod, then finished by hand for the cases the codemod flags as manual.

What the migration covers:

• Imports — @modelcontextprotocol/sdk/* → the scoped v2 packages; StreamableHTTPServerTransport → NodeStreamableHTTPServerTransport (from @modelcontextprotocol/node).
• Registration API — .tool() / .prompt() / .resource() → .registerTool() / .registerPrompt() / .registerResource() with config objects and z.object(...) (Standard Schema) input schemas.
• Request-handler context — the flat extra parameter → the nested v2 ctx (ctx.mcpReq.send, ctx.mcpReq.id, ctx.mcpReq._meta, ctx.sessionId, ctx.http?.authInfo, …).
• Tests — hand-built mock request-handler contexts in the everything suites reshaped from the flat v1 shape ({ sendRequest, requestId, _meta }) to the v2 nested shape ({ mcpReq: { send, id, _meta } }).

All three transports — stdio, SSE, and Streamable HTTP — are retained (SSE via a legacy-transport dependency).

Note: these depend on v2 alpha packages (2.0.0-alpha.x). Intended to land once the v2 SDK is released, or to be merged as a preview/draft.

Server Details

• Server: everything (primary), filesystem, sequentialthinking
• Changes to: dependencies (SDK v1 → v2), tool / prompt / resource registration APIs, the request-handler context, and the servers' test suites. The set of tools / resources / prompts exposed over the wire is unchanged.

Motivation and Context

v2 is a redesign of the TypeScript SDK: scoped, runtime-neutral packages (client / server / core), a restructured request-handler context, Standard-Schema tool inputs, and consolidated error types. Migrating the reference servers keeps them building against the shipping API, exercises the v2 surface end-to-end, and validates the automated v1-to-v2 codemod against a real, non-trivial codebase.

How Has This Been Tested?

• npm test (vitest) passes for every migrated server — 266 tests green total:
  • everything — 5 files / 105 tests (tools 59, plus prompts, resources, registrations, server)
  • filesystem — 7 files / 147 tests
  • sequentialthinking — 1 file / 14 tests
• Type-check (tsc) and build pass.
• Manual LLM-client smoke test — connect over stdio / Streamable HTTP and exercise a few tools (please confirm before submitting).

Breaking Changes

No client-facing configuration change: the servers launch the same way (stdio | sse | streamableHttp) and expose the same tools / resources / prompts. The requirements inherited from SDK v2 are Node.js ≥ 20 (v1's Node 18 support is dropped) and ESM-only. Anyone importing a server as a library must move to the v2 package names.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (Node 20+ / ESM-only; SDK v1 → v2 internal API migration)
• Documentation update (server AGENTS.md / docs/* refreshed for v2)

Checklist

• I have read the MCP Protocol Documentation
• My changes follows MCP security best practices
• I have updated the server's README accordingly (README not touched; docs/* and AGENTS.md were updated)
• I have tested this with an LLM client (please confirm)
• My code follows the repository's style guidelines (run the server's prettier/lint over the migrated output before submitting — codemod output can need formatting cleanup)
• New and existing tests pass locally (266/266 across the three migrated servers)
• I have added appropriate error handling (existing handling preserved by the migration)
• I have documented all environment variables and configuration options (no new env vars / config introduced)

Additional context

• The migration is largely mechanical (codemod-driven). Manual finishing was concentrated in test doubles (mock request-handler contexts) and a few features not carried over in v2.
• The codemod emits advisory diagnostics for the manual cases (e.g. context objects forwarded to helpers, destructured contexts, and hand-built v1 mock contexts in tests), which guided the hand-edits.
• Suggested reviewer focus: the reshaped test mocks in src/everything/__tests__/* and the transport wiring under src/everything/transports/*.