Skip to content

Latest commit

 

History

History
101 lines (61 loc) · 4.92 KB

File metadata and controls

101 lines (61 loc) · 4.92 KB

Ahora que sabemos un poco más sobre SSE, construyamos un servidor SSE a continuación.

Ejercicio: Creando un servidor SSE

Para crear nuestro servidor, debemos tener en cuenta dos cosas:

  • Necesitamos usar un servidor web para exponer endpoints para la conexión y los mensajes.
  • Construir nuestro servidor como normalmente lo hacemos con herramientas, recursos y prompts cuando usábamos stdio.

-1- Crear una instancia del servidor

Para crear nuestro servidor, usamos los mismos tipos que con stdio. Sin embargo, para el transporte, debemos elegir SSE.

Vamos a añadir las rutas necesarias a continuación.

-2- Añadir rutas

Añadamos rutas que manejen la conexión y los mensajes entrantes:

Ahora añadamos capacidades al servidor.

-3- Añadiendo capacidades al servidor

Ahora que tenemos todo lo específico de SSE definido, añadamos capacidades al servidor como herramientas, prompts y recursos.

Tu código completo debería verse así:

Genial, tenemos un servidor usando SSE, probémoslo a continuación.

Ejercicio: Depurando un servidor SSE con Inspector

Inspector es una gran herramienta que vimos en una lección anterior Creando tu primer servidor. Veamos si podemos usar el Inspector aquí también:

-1- Ejecutando el inspector

Para ejecutar el inspector, primero debes tener un servidor SSE corriendo, así que hagámoslo a continuación:

  1. Ejecuta el servidor

  2. Ejecuta el inspector

    ![NOTE] Ejecuta esto en una ventana de terminal separada de donde está corriendo el servidor. También ten en cuenta que necesitas ajustar el comando de abajo para que coincida con la URL donde corre tu servidor.

    npx @modelcontextprotocol/inspector --cli http://localhost:8000/sse --method tools/list

    Ejecutar el inspector es igual en todos los entornos de ejecución. Observa cómo en lugar de pasar una ruta a nuestro servidor y un comando para iniciar el servidor, pasamos la URL donde el servidor está corriendo y también especificamos la ruta /sse.

-2- Probando la herramienta

Conéctate al servidor seleccionando SSE en la lista desplegable y llena el campo de URL donde corre tu servidor, por ejemplo http:localhost:4321/sse. Ahora haz clic en el botón "Connect". Como antes, selecciona listar herramientas, selecciona una herramienta y proporciona valores de entrada. Deberías ver un resultado como el siguiente:

Servidor SSE corriendo en inspector

Genial, puedes trabajar con el inspector, veamos cómo trabajar con Visual Studio Code a continuación.

Tarea

Intenta ampliar tu servidor con más capacidades. Consulta esta página para, por ejemplo, añadir una herramienta que llame a una API. Tú decides cómo debe ser el servidor. ¡Diviértete! :)

Solución

Solución Aquí tienes una posible solución con código funcional.

Puntos clave

Los puntos clave de este capítulo son los siguientes:

  • SSE es el segundo transporte soportado junto a stdio.
  • Para soportar SSE, necesitas gestionar conexiones entrantes y mensajes usando un framework web.
  • Puedes usar tanto Inspector como Visual Studio Code para consumir un servidor SSE, igual que con servidores stdio. Nota cómo difiere un poco entre stdio y SSE. Para SSE, necesitas iniciar el servidor por separado y luego ejecutar tu herramienta inspector. Para la herramienta inspector, también hay algunas diferencias en que debes especificar la URL.

Ejemplos

Recursos adicionales

Qué sigue

Aviso legal:
Este documento ha sido traducido utilizando el servicio de traducción automática Co-op Translator. Aunque nos esforzamos por la precisión, tenga en cuenta que las traducciones automáticas pueden contener errores o inexactitudes. El documento original en su idioma nativo debe considerarse la fuente autorizada. Para información crítica, se recomienda una traducción profesional realizada por humanos. No nos hacemos responsables de malentendidos o interpretaciones erróneas derivadas del uso de esta traducción.