Mark SSE transport as deprecated

未關閉

#2,278 建立於 2026年3月11日 1 則留言 0 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 3/5
預估耗時: 1-2 天
新手友好度: 68/100

Issue 類型: 功能
描述清晰度: 描述清楚
活躍度: 冷清
技術堆疊: python
領域: api, backend

研究方向

從 src/mcp/client/sse.py、src/mcp/server/sse.py 以及 src/mcp/server/mcpserver/server.py 中 issue 指定的 MCPServer 方法開始。比較 TypeScript SDK 中關於 SSE 棄用的措辭，然後驗證列出的 API 會發出 DeprecationWarning，且其文件會將使用者導向 Streamable HTTP，同時說明與舊版伺服器的相容性。

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

描述

improves sdk consistency improves spec compliance P3 v2

The HTTP+SSE transport was replaced by Streamable HTTP in protocol revision 2025-03-26 (spec PR #206). The spec now refers to it as the "deprecated HTTP+SSE transport" and only documents it for backwards compatibility.

The Python SDK still exposes the SSE transport with no indication that it is deprecated.

Proposal

Add warnings.warn(..., DeprecationWarning, stacklevel=2) and @deprecated docstring markers to:

The warning should point users to streamable-http / StreamableHTTPTransport instead.

Prior art

The TypeScript SDK already marks SSEClientTransport as @deprecated with a note to prefer StreamableHTTPClientTransport.

Open questions

Should we remove SSE entirely in v2, or deprecate now and remove in a later major?
The 2024-11-05 spec is still technically valid — clients connecting to old servers may still need the SSE client. The deprecation message should acknowledge this (same as the TS SDK wording does).

_{AI Disclaimer}

主要語言: Python
星號: 24.3k
分支: 4k
平均合併: 1 天 19 分鐘
30 天內合併 PR: 29

貢獻指南

開啟貢獻指南

從這裡開始

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

modelcontextprotocol/python-sdk 的其他 Issue

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日建立
Streamable HTTP stateless servers hang clients on the listen-mode GET (_handle_get_request opens a hold-open SSE stream) 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3492 · 1 則留言 · 2026年9月11日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

[Bug] 发布机 Chrome applet 1.3 打开双语 Web 资产变英文（zh-hans 语言码不命中 zh-CN）未關閉

🐛 Bug 🔔 Pending processing

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

jumpserver/jumpserver#17584 · 2026年9月21日建立
Sphinx ScyllaDB Theme: 1 broken link 未關閉

link-check link-check:sphinx-theme

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

scylladb/scylladb-docs-homepage#274 · 2026年9月21日建立
[Bug] Qwen-Image-2.1 validate_full 未加载训练权重，实际验证的是基座模型未關閉

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

modelscope/DiffSynth-Studio#1702 · 2026年9月21日建立
[feature][processing] Add profile selection options to qgis_process (Request in QGIS) 未關閉

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

qgis/QGIS-Documentation#11275 · 2026年9月21日建立
fix(automation): do not restart an active subject delivery 未關閉

bug priority:normal ready-for-dev

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

OpenHands/extensions#626 · 1 則留言 · 2026年9月21日建立

更多 Python Issue

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