modelcontextprotocol / modelcontextprotocol/php-sdk

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

Ouverte
#337 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

2026-07-28 enhancement improves spec compliance Schema
Langage dominant
PHP
Étoiles
1.6k
Forks
173
Merge moyen
2 j 49 min
PR mergées (30 j)
23

Description

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.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par les sous-tâches #356–#359 et leurs liens SEP. Pour le travail sur les codes d’erreur, examinez src/Schema/JsonRpc/Error.php ainsi que le fallback de version du protocole décrit dans l’issue ; pour le travail sur les schémas, commencez par les exigences concernant SchemaValidator et le vocabulaire JSON Schema indiqué, outputSchema, structuredContent, SSRF et DoS. Le travail est considéré comme terminé lorsque toutes les sous-tâches indiquées sont achevées conformément aux exigences SEP fusionnées.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
php
Domaine
api, backend
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.