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 行为添加测试。完成的标准是实现指定的回退逻辑、验证服务器字段的一致性，并与 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

issue: imported chats all show as unread in the sidebar 未关闭

bug confirmed issue

难度 2/5 1-3 小时新手友好度 75/100

open-webui/open-webui#30750 · 1 条评论 · 2026年9月24日创建
OGS AmBe example has no source.timing block, so every event sits at time zero 未关闭

难度 2/5 1-3 小时新手友好度 75/100

lanl/ScintiPix#61 · 2026年9月24日创建
Make Liquid Glass the default theme for the Research build 未关闭

enhancement

难度 2/5 1-3 小时新手友好度 75/100

OpenwaterHealth/openmotion-bloodflow-app#604 · 1 条评论 · 2026年9月24日创建
tests/puppeteer/test_openai_api_key_ui.js targets controls that do not exist and is run by no workflow 未关闭

难度 2/5 1-3 小时新手友好度 70/100

LearningCircuit/local-deep-research#6766 · 2026年9月23日创建
Delete unused args argument from main() in Python files 未关闭

good first issue

难度 1/5 1 小时以内新手友好度 90/100

ros2/launch#1014 · 2026年9月23日创建

更多 Python Issue