modelcontextprotocol / modelcontextprotocol/python-sdk
Mark SSE transport as deprecated
Chưa có ai nhận issue này.
- Ngôn ngữ chính
- Python
- Star
- 24.3k
- Fork
- 4k
- Merge trung bình
- 1 ngày 1 giờ
- Pull request đã merge (30 ngày)
- 31
Mô tả
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).
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Hướng nghiên cứu
Bắt đầu với src/mcp/client/sse.py, src/mcp/server/sse.py và các phương thức MCPServer được nêu trong issue tại src/mcp/server/mcpserver/server.py. So sánh cách diễn đạt về việc ngừng sử dụng SSE trong TypeScript SDK, sau đó xác minh rằng các API được liệt kê phát ra DeprecationWarning và tài liệu của chúng hướng người dùng đến Streamable HTTP, đồng thời thừa nhận khả năng tương thích với các máy chủ legacy.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- python
- Lĩnh vực
- api, backend
- Loại issue
- Tính năng
- Độ khó
- 3/5
- Thời gian dự kiến
- 1-2 ngày
- Mức độ hoạt động
- Ít trao đổi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức phù hợp với người mới
- 68/100