Implement consistent structuredContent handling per specification clarification

Offen

#1,332 erstellt am 01.9.2025 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 5/5
Geschätzter Aufwand: Über eine Woche
Anfängerfreundlichkeit: 25/100

Issue-Typ: Feature
Klarheit: Muss geklärt werden
Aktivitätsstatus: Veraltet
Tech-Stack: python, typescript
Bereich: api, backend-api-design

Rechercherichtung

Lesen Sie zuerst den Spezifikations-Issue modelcontextprotocol/specification#1411 und den verknüpften TypeScript-SDK-Issue; sie definieren das Verhalten, an das sich dieses Python SDK halten muss. Suchen Sie anschließend die Verarbeitung von Antworten des Python-Clients und -Servers und fügen Sie Tests für das präzisierte Verhalten von structuredContent hinzu. Als abgeschlossen gilt die Implementierung des angegebenen Fallbacks, die Validierung konsistenter Serverfelder und die Übereinstimmung mit dem TypeScript SDK.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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

Vorherrschende Sprache: Python
Sterne: 24.3k
Forks: 4k
Ø Merge: 1 T. 11 Std.
Gemergte PRs (30 T.): 30

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus modelcontextprotocol/python-sdk

OAuth client scope handling breaks on comma-separated scope strings Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100

modelcontextprotocol/python-sdk#3566 · Erstellt am 23.9.2026
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) Offen

v1 v2

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100

modelcontextprotocol/python-sdk#3546 · 5 Kommentare · Erstellt am 19.9.2026
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) Offen

v1 v2

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100

modelcontextprotocol/python-sdk#3545 · 1 Kommentar · Erstellt am 18.9.2026
Revocation requires client_secret to be present Offen

v1 v2

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 91/100

modelcontextprotocol/python-sdk#3508 · 2 Kommentare · Erstellt am 15.9.2026
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 64/100

modelcontextprotocol/python-sdk#3504 · Erstellt am 15.9.2026

Alle Issues in modelcontextprotocol/python-sdk