René's URL Explorer Experiment


Title: feat(mcp): migrate to the stateless MCP 2026-07-28 protocol by antfubot · Pull Request #297 · devframes/devframe · GitHub

Open Graph Title: feat(mcp): migrate to the stateless MCP 2026-07-28 protocol by antfubot · Pull Request #297 · devframes/devframe

X Title: feat(mcp): migrate to the stateless MCP 2026-07-28 protocol by antfubot · Pull Request #297 · devframes/devframe

Description: What & why Migrates devframe's MCP surface to the stateless MCP 2026-07-28 protocol, as tracked in #293. It retires devframe's hand-rolled Mcp-Session-Id lifecycle in favor of the SDK's stateless serving entry points, so requests reach any server instance without session affinity and modern MCP clients are first-class. The endpoints keep serving 2025-era clients through the SDK's default stateless legacy path — the custom session registry is gone, but existing clients keep listing and calling tools/resources. Compatibility (ships within 0.9) This is source-compatible — no public API, option-type, or dependency changes (the tsnapi snapshot is unchanged), so consumers need zero code changes and it lands as a 0.9 minor rather than a dedicated major. The changes are on the wire only: GET/DELETE on the HTTP endpoint now return 405 (were the 2025 session stream/teardown ops). No Mcp-Session-Id is issued; both a default (2025-era) client and a modern client connect + list + call successfully. The one regression: a 2025-era client no longer receives live list_changed push over HTTP (stateless legacy has no server→client channel); modern clients get it via subscriptions/listen. Changes HTTP (createMcpFetchHandler) moves to the SDK's createMcpHandler, building a fresh server per request. The loopback origin gate is unchanged. stdio (createMcpServer) moves to serveStdio, pinning one server per connection. devframe connect negotiates the modern era via server/discover, falling back to the 2025 handshake for a 2025-only instance. list_changed events bridge onto modern subscriptions/listen streams — over HTTP through the handler's notify bus, on stdio through the pinned server's send*ListChanged calls. The pure server factory (buildMcpServerFromContext) is split from the notification bridge (bridgeListChanged); the old transports.ts stdio wrapper is removed. Docs Rewrites the MCP adapter page's serving model (stateless, per-request). Documents the change as a section in the "Migrating to 0.9" guide. Closes #293 This PR was created with the help of an agent.

Open Graph Description: What & why Migrates devframe's MCP surface to the stateless MCP 2026-07-28 protocol, as tracked in #293. It retires devframe's hand-rolled Mcp-Session-Id lifecycle in favor of the SDK&#...

X Description: What & why Migrates devframe's MCP surface to the stateless MCP 2026-07-28 protocol, as tracked in #293. It retires devframe's hand-rolled Mcp-Session-Id lifecycle in favor ...

Opengraph URL: https://github.com/devframes/devframe/pull/297

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:4c01318e-c89d-4bea-c0cc-4007f123098b
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idBFF0:3222F:18E261:21C692:6AFBAB62
html-safe-nonce3168b0a3b49731344c693af9ed9e4208f5fe2cbf425d67b662bd9c4440da959f
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCRkYwOjMyMjJGOjE4RTI2MToyMUM2OTI6NkFGQkFCNjIiLCJ2aXNpdG9yX2lkIjoiNTY1Mjg0NzEzMjg0Nzg3Njk2MiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmace49d1531038564103e67977e5c6c8b4d6dc850f8708ce612e89d97629cae893a
hovercard-subject-tagpull_request:4363827584
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/devframes/devframe/pull/297/files
twitter:imagehttps://avatars.githubusercontent.com/u/291667613?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/291667613?s=400&v=4
og:image:altWhat & why Migrates devframe's MCP surface to the stateless MCP 2026-07-28 protocol, as tracked in #293. It retires devframe's hand-rolled Mcp-Session-Id lifecycle in favor of the SDK&#...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Nonee25fbd830d3e6ad0e8935c105cf4fdc70c593dffcd27bb45b790ae4fece5ea55
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/devframes/devframe git https://github.com/devframes/devframe.git
octolytics-dimension-user_id279879373
octolytics-dimension-user_logindevframes
octolytics-dimension-repository_id1231722386
octolytics-dimension-repository_nwodevframes/devframe
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id1231722386
octolytics-dimension-repository_network_root_nwodevframes/devframe
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release08c8f17f9d27054a108b8b6254e405de0151f660
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/devframes/devframe/pull/297/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fdevframes%2Fdevframe%2Fpull%2F297%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fdevframes%2Fdevframe%2Fpull%2F297%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=devframes%2Fdevframe
Reloadhttps://github.com/devframes/devframe/pull/297/files
Reloadhttps://github.com/devframes/devframe/pull/297/files
Reloadhttps://github.com/devframes/devframe/pull/297/files
devframeshttps://github.com/devframes
devframehttps://github.com/devframes/devframe
Codehttps://github.com/devframes/devframe
Issues12 (12)https://github.com/devframes/devframe/issues
Pull requests13 (13)https://github.com/devframes/devframe/pulls
Actionshttps://github.com/devframes/devframe/actions
Security and qualityhttps://github.com/devframes/devframe/security
Insightshttps://github.com/devframes/devframe/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fdevframes%2Fdevframe%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fdevframes%2Fdevframe%2Fissues%2Fnew%2Fchoose
antfuhttps://github.com/antfu
mainhttps://github.com/devframes/devframe/tree/main
feat/mcp-stateless-2026https://github.com/devframes/devframe/tree/feat/mcp-stateless-2026
Conversation 1 https://github.com/devframes/devframe/pull/297
Commits 4 https://github.com/devframes/devframe/pull/297/commits
Checks 10 https://github.com/devframes/devframe/pull/297/checks
Files changed https://github.com/devframes/devframe/pull/297/files
Please reload this pagehttps://github.com/devframes/devframe/pull/297/files
feat(mcp): migrate to the stateless MCP 2026-07-28 protocol https://github.com/devframes/devframe/pull/297/files#top
Show all changes 4 commits https://github.com/devframes/devframe/pull/297/files
15b75be feat(mcp): migrate to the stateless MCP 2026-07-28 protocol antfubot Aug 26, 2026 https://github.com/devframes/devframe/pull/297/commits/15b75be3e310a0510ef03c5bf7c2d5c2f6dd876c
f451229 test(mcp): update stateful MCP assertions for the stateless endpoint antfubot Aug 26, 2026 https://github.com/devframes/devframe/pull/297/commits/f45122913b50acc11d8cdacd1d7f5c6a55c0772d
b7b2d59 Merge remote-tracking branch 'origin/main' into feat/mcp-stateless-2026 antfubot Aug 27, 2026 https://github.com/devframes/devframe/pull/297/commits/b7b2d599e14a2536d092c79cf30699c2ed30a872
542edae docs(mcp): fold the stateless MCP change into the 0.9 migration guide antfubot Aug 27, 2026 https://github.com/devframes/devframe/pull/297/commits/542edaeb5ac6606c7941e8cf7f0a8d65d104b265
Clear filters https://github.com/devframes/devframe/pull/297/files
Please reload this pagehttps://github.com/devframes/devframe/pull/297/files
Please reload this pagehttps://github.com/devframes/devframe/pull/297/files
7.mcp.md https://github.com/devframes/devframe/pull/297/files#diff-769d96ffd948ba24074be6c6f8b457d5b1cd3df1633a14a996aa98344bc95b57
1.migration-0.9.md https://github.com/devframes/devframe/pull/297/files#diff-978167fd307b289d7c129168a5602318b030f057e1fb0311dd1620b67e9c472f
index.md https://github.com/devframes/devframe/pull/297/files#diff-ce693471bd7509b44e5d11fdcd33015ab9fe8e23d7d2559b1a9fcdb7ed9997d1
mcp-http.test.ts https://github.com/devframes/devframe/pull/297/files#diff-75298bb529f60691aa6fe98e627c3aa703ed6c38487099adce08fe052cbf8897
mcp-server.test.ts https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
build-server.ts https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
fetch.ts https://github.com/devframes/devframe/pull/297/files#diff-a3559c52ab6089920f5b15fcba76789dcb2dd60d53b4b2c698c5baaba21b8431
http.ts https://github.com/devframes/devframe/pull/297/files#diff-c8e06448650899fec7a30e09972e0f4669bd6a2efd6140db0157416c4cecb311
transports.ts https://github.com/devframes/devframe/pull/297/files#diff-f8fd0f20147ff124438f9dfa0c6c532ae25a6c18b348ff3e098f25c3a3ea2e88
connect.ts https://github.com/devframes/devframe/pull/297/files#diff-2576e5f383e5161b033a423e30c8aa94873f40aa00ce550590738d9cad90a9e5
initiate.test.ts https://github.com/devframes/devframe/pull/297/files#diff-25706eadb28a322bb2a43ffff82c94d39cf906ed65c2d9a10b26ee6fc3d4e907
initiate.ts https://github.com/devframes/devframe/pull/297/files#diff-500061a187e404009222ccd84a3d851545df0a3826241909a3b3b3d9580a4b02
handler.test.ts https://github.com/devframes/devframe/pull/297/files#diff-b6b08be9c92966cd50a6adeef04ce10723148599c6fdb1efc009125aec142b09
optional-mcp-bundles.test.ts https://github.com/devframes/devframe/pull/297/files#diff-92ddbf9adf88b76186eda4372f24e80630f59a47c6118869a432b3a6806fd315
docs/content/2.adapters/7.mcp.mdhttps://github.com/devframes/devframe/pull/297/files#diff-769d96ffd948ba24074be6c6f8b457d5b1cd3df1633a14a996aa98344bc95b57
View file https://github.com/devframes/devframe/blob/542edaeb5ac6606c7941e8cf7f0a8d65d104b265/docs/content/2.adapters/7.mcp.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/297/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/297/files#diff-769d96ffd948ba24074be6c6f8b457d5b1cd3df1633a14a996aa98344bc95b57
https://github.com/devframes/devframe/pull/297/files#diff-769d96ffd948ba24074be6c6f8b457d5b1cd3df1633a14a996aa98344bc95b57
https://github.com/devframes/devframe/pull/297/files#diff-769d96ffd948ba24074be6c6f8b457d5b1cd3df1633a14a996aa98344bc95b57
docs/content/7.migrations/1.migration-0.9.mdhttps://github.com/devframes/devframe/pull/297/files#diff-978167fd307b289d7c129168a5602318b030f057e1fb0311dd1620b67e9c472f
View file https://github.com/devframes/devframe/blob/542edaeb5ac6606c7941e8cf7f0a8d65d104b265/docs/content/7.migrations/1.migration-0.9.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/297/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/297/files#diff-978167fd307b289d7c129168a5602318b030f057e1fb0311dd1620b67e9c472f
https://github.com/devframes/devframe/pull/297/files#diff-978167fd307b289d7c129168a5602318b030f057e1fb0311dd1620b67e9c472f
docs/content/7.migrations/index.mdhttps://github.com/devframes/devframe/pull/297/files#diff-ce693471bd7509b44e5d11fdcd33015ab9fe8e23d7d2559b1a9fcdb7ed9997d1
View file https://github.com/devframes/devframe/blob/542edaeb5ac6606c7941e8cf7f0a8d65d104b265/docs/content/7.migrations/index.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/297/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/297/files#diff-ce693471bd7509b44e5d11fdcd33015ab9fe8e23d7d2559b1a9fcdb7ed9997d1
https://github.com/devframes/devframe/pull/297/files#diff-ce693471bd7509b44e5d11fdcd33015ab9fe8e23d7d2559b1a9fcdb7ed9997d1
packages/devframe/src/adapters/mcp/__tests__/mcp-http.test.tshttps://github.com/devframes/devframe/pull/297/files#diff-75298bb529f60691aa6fe98e627c3aa703ed6c38487099adce08fe052cbf8897
View file https://github.com/devframes/devframe/blob/542edaeb5ac6606c7941e8cf7f0a8d65d104b265/packages/devframe/src/adapters/mcp/__tests__/mcp-http.test.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/297/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/297/files#diff-75298bb529f60691aa6fe98e627c3aa703ed6c38487099adce08fe052cbf8897
https://github.com/devframes/devframe/pull/297/files#diff-75298bb529f60691aa6fe98e627c3aa703ed6c38487099adce08fe052cbf8897
https://github.com/devframes/devframe/pull/297/files#diff-75298bb529f60691aa6fe98e627c3aa703ed6c38487099adce08fe052cbf8897
packages/devframe/src/adapters/mcp/__tests__/mcp-server.test.tshttps://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
View file https://github.com/devframes/devframe/blob/542edaeb5ac6606c7941e8cf7f0a8d65d104b265/packages/devframe/src/adapters/mcp/__tests__/mcp-server.test.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/297/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
https://github.com/devframes/devframe/pull/297/files#diff-b9f4255e93bed1731f87358ad736ae48826b21b267c4d2cb6169e3c18453ff71
packages/devframe/src/adapters/mcp/build-server.tshttps://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
View file https://github.com/devframes/devframe/blob/542edaeb5ac6606c7941e8cf7f0a8d65d104b265/packages/devframe/src/adapters/mcp/build-server.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/devframes/devframe/pull/297/{{ revealButtonHref }}
https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
https://github.com/devframes/devframe/pull/297/files#diff-2b6bd0e918d09b12d611485e8fe7afea4ca092dc16a509c97d1002f74e9ad14a
Please reload this pagehttps://github.com/devframes/devframe/pull/297/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.