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 天 1 小时
30 天内合并 PR: 31

贡献指南

打开贡献指南

从这里开始

先读完整个 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 · 4 条评论 · 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

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日创建
[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日创建
Change observation tooltip text 未关闭

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

CSCfi/sd-search-api#39 · 2026年9月21日创建
Schema regression: derivation conversion_failure reverted 未关闭

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

elong0527/yamaa#708 · 2026年9月21日创建

更多 Python Issue

精选适合新手参与的 GitHub issue 摘要。