modelcontextprotocol / modelcontextprotocol/java-sdk

SEP-2243: HTTP Header Standardization for Streamable HTTP Transport

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

Personne n'a encore pris cette issue.

area/server area/transport enhancement P1
Langage dominant
Java
Étoiles
3.7k
Forks
1.1k
Merge moyen
1 j 15 h
PR mergées (30 j)
9

Description

Description

Per SEP-2243 (HTTP Standard Headers), MCP clients MUST send the following HTTP headers on POST requests:

  • Mcp-Method: Set to the JSON-RPC method value from the request body (REQUIRED on every POST)
  • Mcp-Name: Set from params.name (for tools/call, prompts/get) or params.uri (for resources/read, resources/subscribe, resources/unsubscribe) when present

Context

The cxxmcp (C++ SDK) conformance testing revealed that the official conformance test suite's reference client (TypeScript SDK) does not send these headers, making the conformance suite self-contradictory. See:

Impact

Servers that enforce SEP-2243 (reject missing Mcp-Method with HTTP 400) are incompatible with clients that don't send these headers. This affects cross-SDK interoperability.

Request

Please implement Mcp-Method and Mcp-Name header support per SEP-2243 to ensure cross-SDK compatibility.

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 le client de transport HTTP streamable du Java SDK et suivez la manière dont les requêtes POST sont construites. Utilisez SEP-2243 et les champs du corps de la requête décrits ici pour déterminer les valeurs des en-têtes ; le travail est terminé lorsque les requêtes POST concernées envoient Mcp-Method et Mcp-Name afin que les serveurs qui appliquent la norme les acceptent.

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

Évaluation

Stack technique
java
Domaine
api
Type d'issue
Fonctionnalité
Difficulté
3/5
Temps estimé
1-2 jours
Activité
Active
Clarté
Plutôt claire
Accessibilité débutants
68/100

Recevez les nouvelles issues par e-mail

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