Implement consistent structuredContent handling per specification clarification

オープン

#1,332 2025年9月1日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 5/5
見積もり時間: 1週間以上
初心者へのやさしさ: 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時間
マージ済み PR（30日）: 30

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
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 をもっと見る