Implement consistent structuredContent handling per specification clarification

Aperta

#1,332 aperta il 1/9/2025 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà: 5/5
Tempo stimato: Più di una settimana
Idoneità per principianti: 25/100

Tipo di issue: Funzionalità
Chiarezza: Da chiarire
Stato di attività: Ferma
Stack tecnologico: python, typescript
Ambito: api, backend-api-design

Direzione di ricerca

Leggi prima l’issue della specifica modelcontextprotocol/specification#1411 e l’issue collegata del TypeScript SDK; definiscono il comportamento a cui questo Python SDK deve conformarsi. Poi individua la gestione delle risposte del client e del server Python e aggiungi test per il comportamento chiarito di structuredContent. Il lavoro è completato quando è stato implementato il fallback specificato, sono stati convalidati i campi coerenti del server e il risultato corrisponde al TypeScript SDK.

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

Descrizione

bug enhancement needs decision P3 pending SEP approval

Summary

Following the specification issue modelcontextprotocol/specification#1411, the Python SDK needs to ensure consistent handling of structuredContent vs content fields in tool responses.

Problem

Currently there's inconsistency across MCP implementations:

Some clients use structuredContent when available (e.g., Cursor)
Others ignore it entirely
This leads to different behavior with the same servers

Current SDK Behavior

The Python SDK needs to be reviewed to ensure it properly handles the relationship between structuredContent and content fields.

Required Changes

Once modelcontextprotocol/specification#1411 is resolved, update the SDK to:

Implement the specified client behavior for structuredContent
Ensure proper fallback to content when needed
Validate that servers populate both fields consistently
Add tests to verify the correct behavior
Ensure consistency with the TypeScript SDK implementation

References

Specification issue: modelcontextprotocol/specification#1411
TypeScript SDK issue: modelcontextprotocol/typescript-sdk#911
Discord discussion: https://discord.com/channels/1358869848138059966/1411057080902746293

cc: @dsp-ant

Lingua principale: Python
Stelle: 24.3k
Fork: 4k
Merge medio: 1g 16h
PR unite (30g): 25

Guida per i contributori

Apri la guida per i contributori

Come iniziare

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