FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Migrate ext-apps to @modelcontextprotocol/server v2 SDK by khandrew1 · Pull Request #710 · modelcontextprotocol/ext-apps · GitHub

/ ext-apps Public

Migrate ext-apps to @modelcontextprotocol/server v2 SDK - #710

Closed
khandrew1 wants to merge 7 commits into
modelcontextprotocol:mainfrom
khandrew1:codex/mcp-sdk-v2-beta4-migration
ConversationCommits (7)ChecksFiles changed
Closed

Migrate ext-apps to @modelcontextprotocol/server v2 SDK#710
khandrew1 wants to merge 7 commits into
modelcontextprotocol:mainfrom
khandrew1:codex/mcp-sdk-v2-beta4-migration

Conversation

khandrew1 commented Jul 15, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Migrates the Apps SDK to the base MCP SDK v2.0.0-beta.4 split packages, replacing @modelcontextprotocol/sdk v1 across the codebase. This is a breaking dependency update; App protocol negotiation and behavior remain unchanged.

  • Refactors

    • App now subclasses @modelcontextprotocol/client Client; AppBridge subclasses @modelcontextprotocol/server Server for the inner iframe, with a separate outer Client to the MCP server.
    • Preserves the inner double handshake and Apps-ready gate; replaces protocol inheritance with a composed EventDispatcher.
    • Updates examples to use @modelcontextprotocol/express, @modelcontextprotocol/node (NodeStreamableHTTPServerTransport), and @modelcontextprotocol/server/stdio.
    • Standardizes schemas to z.object({...}); updates docs/snippets; externalizes peer deps for @modelcontextprotocol/{client,core,server} and zod in standard builds.
    • Regenerates lockfile for npm 10.

  • Migration

    • Install and pin: @modelcontextprotocol/client@2.0.0-beta.4, @modelcontextprotocol/server@2.0.0-beta.4, @modelcontextprotocol/core@2.0.0-beta.4, and zod@^4.2.0 (examples may also need @modelcontextprotocol/express and @modelcontextprotocol/node).
    • Update imports from @modelcontextprotocol/sdk v1 to the split packages (e.g., createMcpExpressApp from @modelcontextprotocol/express, StdioServerTransport from @modelcontextprotocol/server/stdio).
    • Change tool/resource schemas to z.object({ ... }); remove .shape usage and pass Zod schemas directly.
    • Ensure Node 20+; reinstall and rebuild (npm install, then build/tests).

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

Additional context

khandrew1 changed the title Codex/mcp sdk v2 beta4 migration Migrate ext-apps to @modelcontextprotocol/server v2 SDK Jul 15, 2026

pkg-pr-new Bot commented Jul 15, 2026

Copy link
Copy Markdown

Open in StackBlitz

@modelcontextprotocol/ext-apps

npm i https://pkg.pr.new/@modelcontextprotocol/ext-apps@710

@modelcontextprotocol/server-basic-preact

npm i https://pkg.pr.new/@modelcontextprotocol/server-basic-preact@710

@modelcontextprotocol/server-basic-react

npm i https://pkg.pr.new/@modelcontextprotocol/server-basic-react@710

@modelcontextprotocol/server-basic-solid

npm i https://pkg.pr.new/@modelcontextprotocol/server-basic-solid@710

@modelcontextprotocol/server-basic-svelte

npm i https://pkg.pr.new/@modelcontextprotocol/server-basic-svelte@710

@modelcontextprotocol/server-basic-vanillajs

npm i https://pkg.pr.new/@modelcontextprotocol/server-basic-vanillajs@710

@modelcontextprotocol/server-basic-vue

npm i https://pkg.pr.new/@modelcontextprotocol/server-basic-vue@710

@modelcontextprotocol/server-budget-allocator

npm i https://pkg.pr.new/@modelcontextprotocol/server-budget-allocator@710

@modelcontextprotocol/server-cohort-heatmap

npm i https://pkg.pr.new/@modelcontextprotocol/server-cohort-heatmap@710

@modelcontextprotocol/server-customer-segmentation

npm i https://pkg.pr.new/@modelcontextprotocol/server-customer-segmentation@710

@modelcontextprotocol/server-debug

npm i https://pkg.pr.new/@modelcontextprotocol/server-debug@710

@modelcontextprotocol/server-lazy-auth

npm i https://pkg.pr.new/@modelcontextprotocol/server-lazy-auth@710

@modelcontextprotocol/server-map

npm i https://pkg.pr.new/@modelcontextprotocol/server-map@710

@modelcontextprotocol/server-pdf

npm i https://pkg.pr.new/@modelcontextprotocol/server-pdf@710

@modelcontextprotocol/server-scenario-modeler

npm i https://pkg.pr.new/@modelcontextprotocol/server-scenario-modeler@710

@modelcontextprotocol/server-shadertoy

npm i https://pkg.pr.new/@modelcontextprotocol/server-shadertoy@710

@modelcontextprotocol/server-sheet-music

npm i https://pkg.pr.new/@modelcontextprotocol/server-sheet-music@710

@modelcontextprotocol/server-system-monitor

npm i https://pkg.pr.new/@modelcontextprotocol/server-system-monitor@710

@modelcontextprotocol/server-threejs

npm i https://pkg.pr.new/@modelcontextprotocol/server-threejs@710

@modelcontextprotocol/server-transcript

npm i https://pkg.pr.new/@modelcontextprotocol/server-transcript@710

@modelcontextprotocol/server-video-resource

npm i https://pkg.pr.new/@modelcontextprotocol/server-video-resource@710

@modelcontextprotocol/server-wiki-explorer

npm i https://pkg.pr.new/@modelcontextprotocol/server-wiki-explorer@710

commit: f50ec6e

This was referenced Jul 15, 2026
Merged
Closed
This was referenced Jul 20, 2026
Draft
Draft
Draft
Draft
This was referenced Jul 21, 2026
Open
Open
tomber mentioned this pull request Jul 27, 2026
Merged
5 tasks
This was referenced Jul 28, 2026
Open
Open
khandrew1 closed this Jul 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Show hidden characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Migrate ext-apps to @modelcontextprotocol/server v2 SDK

1 participant

Back | FazBrowse Home | New Git URL