modelcontextprotocol / modelcontextprotocol/php-sdk

[2026-07-28] Schema modernization & error code standardization

Offen
#337 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

2026-07-28 enhancement improves spec compliance Schema
Vorherrschende Sprache
PHP
Sterne
1.6k
Forks
173
Ø Merge
2 T. 49 Min.
Gemergte PRs (30 T.)
23

Beschreibung

Tracking issue for the MCP Spec 2026-07-28 releaseSchema & errors milestone.

SEPs covered

SEP Title Spec PR
SEP-2106 Tools inputSchema/outputSchema conform to JSON Schema 2020-12 #2106
SEP-2164 Standardize resource-not-found error code to -32602 #2164

Sub-issues

SEP-2106 (JSON Schema 2020-12):

  • #356 — Vocabulary support (oneOf/anyOf/allOf/if-then-else/$ref)
  • #357 — Allow non-object outputSchema and structuredContent
  • #358 — Harden SchemaValidator against external $ref SSRF and composition DoS

SEP-2164:

  • #359 — Switch resource-not-found error code to -32602 with protocol-version-aware fallback

Notes

  • Both SEPs are merged.
  • SEP-2106 is the largest code-level lift this cycle for the schema layer: full JSON Schema 2020-12 vocabulary (composition, conditionals, $ref), plus non-object outputSchema / structuredContent. Also requires hardening against external $ref SSRF and composition DoS.
  • SEP-2164 is mechanically a one-constant flip in src/Schema/JsonRpc/Error.php with a protocol-version-aware fallback.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne mit den Unteraufgaben #356–#359 und ihren SEP-Links. Für die Arbeit an den Fehlercodes sieh dir src/Schema/JsonRpc/Error.php und den im Issue beschriebenen Fallback für die Protokollversion an; für die Schema-Arbeit beginne mit den Anforderungen an SchemaValidator und die aufgeführten JSON-Schema-Vokabulare, outputSchema, structuredContent, SSRF und DoS. Als erledigt gilt die Arbeit, wenn alle aufgeführten Unteraufgaben gemäß den zusammengeführten SEP-Anforderungen abgeschlossen sind.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
php
Bereich
api, backend
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.