Implement consistent structuredContent handling per specification clarification

未關閉

#1,332 建立於 2025年9月1日 1 則留言 0 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 5/5
預估耗時: 一週以上
新手友好度: 25/100

Issue 類型: 功能
描述清晰度: 需要釐清
活躍度: 停滯
技術堆疊: python, typescript
領域: api, backend-api-design

研究方向

首先閱讀規格 issue modelcontextprotocol/specification#1411 以及連結的 TypeScript SDK issue；它們定義了此 Python SDK 必須符合的行為。接著找出 Python 用戶端和伺服器的回應處理，並為已釐清的 structuredContent 行為新增測試。完成的標準是實作指定的 fallback、驗證伺服器欄位的一致性，並與 TypeScript SDK 保持一致。

由索引模型根據 Issue 內容生成。

描述

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

主要語言: Python
星號: 24.3k
分支: 4k
平均合併: 1 天 11 小時
30 天內合併 PR: 30

貢獻指南

開啟貢獻指南

從這裡開始

先讀完整個 Issue，再讀專案的貢獻指南。
在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
Fork 儲存庫，在一個分支上完成修改。
送出 Pull Request，並在描述裡引用這個 Issue 編號。

modelcontextprotocol/python-sdk 的其他 Issue

OAuth client scope handling breaks on comma-separated scope strings 未關閉

難度 2/5 1-3 小時新手友好度 75/100

modelcontextprotocol/python-sdk#3566 · 2026年9月23日建立
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 85/100

modelcontextprotocol/python-sdk#3546 · 5 則留言 · 2026年9月19日建立
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 76/100

modelcontextprotocol/python-sdk#3545 · 1 則留言 · 2026年9月18日建立
Revocation requires client_secret to be present 未關閉

v1 v2

難度 1/5 1 小時以內新手友好度 91/100

modelcontextprotocol/python-sdk#3508 · 2 則留言 · 2026年9月15日建立
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? 未關閉

難度 2/5 1-3 小時新手友好度 64/100

modelcontextprotocol/python-sdk#3504 · 2026年9月15日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

PATCH /interviews/{id} 的 goal 字段没有任何长度上限，500KB 字符串直接落库且每次 GET detail 都全量带回未關閉

bug

難度 2/5 1-3 小時新手友好度 75/100

xinnan-tech/xiaozhi-fde-talk#263 · 2026年9月24日建立
rules: REQ-0480 'left fold' jargon is redundant with its own plain restatement 未關閉

rules

難度 1/5 1 小時以內新手友好度 90/100

elong0527/yamaa#978 · 2026年9月24日建立
Validation discards output from runners that report on stderr (jest, unittest) 未關閉

難度 2/5 1-3 小時新手友好度 70/100

huggingface/Repo2RLEnv#163 · 1 則留言 · 2026年9月24日建立
Source link in quantize_embeddings have shifted code highlights 未關閉

難度 1/5 1 小時以內新手友好度 95/100

huggingface/sentence-transformers#4074 · 2026年9月24日建立
Queue insertion button ("插入排队消息") missing in api_server sessions — canInsert allowlist only covers cli/global_agent 未關閉

comp/dashboard invalid P3

難度 2/5 1-3 小時新手友好度 70/100

NousResearch/hermes-agent#121143 · 2026年9月24日建立

更多 Python Issue

精選適合新手參與的 GitHub issue 摘要。