Transmitir respuestas con SSE

Algunas herramientas tardan un tiempo: una búsqueda larga o una llamada lenta a una API. En lugar de hacer que el cliente espere en silencio, el servidor puede transmitir actualizaciones a medida que se producen. ⏳

Streamable HTTP transmite mediante Server-Sent Events, o SSE. Es una forma sencilla y propia de la web para que un servidor envíe una secuencia de mensajes por una única conexión abierta.

SSE fluye en una sola dirección: del servidor al cliente. El servidor mantiene abierta la conexión y envía eventos por ella cada vez que tiene algo nuevo que comunicar.

Sabrá que una respuesta es un flujo por su Content-Type. Cuando el servidor lo establece en text/event-stream, el cliente lee eventos en lugar de un único cuerpo final.

Cada evento SSE es simplemente texto. Las líneas que comienzan por data: contienen la carga útil y una línea en blanco marca el final de un evento antes de que comience el siguiente.

Dentro de cada evento se encuentra un mensaje JSON-RPC conocido. La transmisión no inventa un formato nuevo; simplemente entrega los mismos mensajes a lo largo del tiempo.

Una respuesta transmitida puede enviar primero notificaciones de progreso y dejar el resultado final para el final. El usuario ve que la herramienta está funcionando en lugar de quedarse mirando un indicador de carga.

La transmisión es opcional. Para una herramienta rápida, el servidor puede devolver una única respuesta JSON y cerrar la conexión, sin necesidad de ningún flujo de eventos.

SSE permite que el servidor etiquete los eventos con un id. Ese pequeño detalle será importante más adelante: así es como un cliente puede reanudar un flujo después de perder la conexión.

Rara vez tendrá que escribir SSE sin ayuda. El SDK de MCP da formato a los eventos; usted solo envía el progreso y los resultados, y el SDK los transmite correctamente.

La transmisión no cambia lo que devuelve una herramienta, solo cómo se siente. La respuesta final es idéntica; el usuario simplemente disfruta de una experiencia más fluida y receptiva. ✨

SSE permite que el servidor envíe eventos JSON-RPC por una única conexión abierta: primero el progreso y por último el resultado. Es opcional, propio de la web y hace que las herramientas lentas parezcan rápidas. 🎉