Mark SSE transport as deprecated

Abierto

#2,278 abierto el 11/3/2026 1 comentario 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad: 3/5
Tiempo estimado: 1-2 días
Aptitud para principiantes: 68/100

Tipo de issue: Nueva funcionalidad
Claridad: Bien especificado
Estado de actividad: Tranquilo
Stack tecnológico: python
Área: api, backend

Línea de trabajo

Comienza con src/mcp/client/sse.py, src/mcp/server/sse.py y los métodos de MCPServer mencionados en el issue en src/mcp/server/mcpserver/server.py. Compara la redacción de la obsolescencia de SSE del TypeScript SDK y, después, verifica que las APIs enumeradas emitan DeprecationWarning y que su documentación dirija a los usuarios a Streamable HTTP, reconociendo al mismo tiempo la compatibilidad con servidores heredados.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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}