Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Track migration to MCP spec 2026-07-28 (stateless model)

Aperta
#40 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
38/100
Tipo di issue
Refactoring
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Stack tecnologico
typescript
Ambito
api, backend

Direzione di ricerca

Inizia ispezionando il codice di trasporto e gestione delle sessioni in src/ e conferma la versione corrente dell'SDK e le indicazioni per la migrazione alla specifica del 2026-07-28. Verifica il supporto effettivo dei client e se il server presuppone lo stateful handshake; il lavoro è concluso quando l'ambito di migrazione richiesto è stato identificato e le modifiche di trasporto necessarie sono state completate o documentate chiaramente.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

The MCP spec released a new revision on 2026-07-28 (announced at https://blog.modelcontextprotocol.io/posts/2026-07-28/) that moves from the stateful bidirectional protocol to a stateless request/response model — eliminating the initialize/initialized handshake and session IDs, replacing server-initiated elicitation with "Multi Round-Trip Requests" (MRTR), and deprecating Sampling, Roots, and Logging (12-month minimum deprecation window).

As of this issue, @modelcontextprotocol/sdk on npm is still on the 1.x line (1.30.0 latest) — no separate 2.0.0 package exists. The spec appears to be supported via 1.x releases.

Why this is lower-priority here than in the other Mapbox MCP servers

Verified (grep -rn "elicitInput\|createMessage" src/): this repo uses neither elicitation nor sampling anywhere. Unlike mcp-server (mapbox/mcp-server#245) and mcp-devkit-server (mapbox/mcp-devkit-server#130), there's no elicitation-based or sampling-based UX here that the spec's deprecations would force a redesign of. The remaining relevant surface is just the stateless request/response transport model itself.

What to check before starting

  • Confirm real client support for the new stateless model (Claude Desktop, Claude Code, VS Code Copilot).
  • Read the SDK's actual migration guide for the TypeScript SDK version(s) implementing 2026-07-28 support.
  • Check whether anything in this server's transport/session handling assumes the old stateful handshake.

Non-goals for now

  • No urgency given the 12-month deprecation window.
  • The routine SDK dependency bump (1.29.0 → 1.30.0) is handled separately and does not itself adopt the new spec — see the corresponding PR.
Lingua principale
TypeScript
Stelle
1
Fork
1
Merge medio
2g 23h
PR unite (30g)
1

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di mapbox/mcp-docs-server

Tutte le issue di mapbox/mcp-docs-server

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.