0:007:18

Recursos

Resumen

¿Cómo conectas un cliente MCP con un servidor que ya expone recursos y herramientas? Aquí aprendes a construir ese cliente en Python para consumir lo que el servidor ofrece, pensado para quien ya desplegó un servidor MCP y quiere cerrar el ciclo de comunicación.

Un servidor por sí solo no sirve de mucho si nadie consume lo que facilita. Por eso, después de tener un servidor con una herramienta y un recurso desplegados, el siguiente paso es crear a su media naranja: el cliente. Este cliente se encarga de consumir los recursos que el servidor pone a disposición.

¿Cómo organizas los archivos para un cliente MCP?

Todo empieza con el orden. Lo primero es crear una carpeta llamada clase cinco, escrita correctamente para que sea cómodo encontrarla dentro del repositorio.

Dentro de esa carpeta copias el mismo server.py que venías usando. ¿Por qué ahí mismo? Porque el cliente necesita ubicarlo para levantarlo. Luego creas un archivo nuevo: client.py, que será el corazón de esta comunicación [0:18].

¿Qué hace un cliente MCP? Se comunica con el servidor, consulta qué recursos y herramientas ofrece, y los ejecuta. Es el puente entre el servidor, que responde en un formato técnico, y el usuario final, que quiere respuestas legibles.

¿Qué necesitas importar para que el cliente hable con el servidor?

Dentro de client.py, lo primero es importar las bibliotecas de clases que harán posible la conexión.

Se importan ClientSession, StdioServerParameters y mcp.client.stdio. Estas dos sentencias de import permiten que el cliente se comunique con el servidor [0:55].

Después configuras los parámetros del servidor. Y aquí entra la lógica:

  • El comando es mcp.
  • Los argumentos son run y server.py.
  • Por eso era necesario copiar server.py dentro de la carpeta clase cinco.

Con esos parámetros listos, ejecutas la función principal, la que inicializa la sesión de comunicación con el servidor. Al puro estilo de Python, usas una sentencia main para ejecutar esa función [1:38].

¿Cómo listas los recursos y herramientas del servidor?

Una vez que la sesión está inicializada y el servidor se comunica directamente contigo, quieres saber todo lo que ese servidor puede ofrecer.

Para eso agregas dos bloques dentro del método run: uno que enlista los recursos y otro que enlista las herramientas. No se verá tan pulido como en el inspector de MCP, sino de una forma más austera, pero cumple la misma función [2:30].

  • Con resources pides un listado de todos los recursos y los recorres con un for.
  • Con tools y await session.list_tools obtienes el listado de herramientas, igual que aparecía en el inspector [3:14].
  • Cada elemento se enumera con un print, ya sea print resource o print tool.

Pero enlistar no es lo único interesante. También puedes leer un recurso directamente.

¿Cómo lees un recurso o ejecutas una herramienta desde el cliente?

Unas líneas más abajo agregas la opción de leer un recurso con session.read_resource, por ejemplo el recurso de saludo que ya sabes que existe en tu servidor.

Luego haces lo mismo con una herramienta. Tu servidor tiene una herramienta de suma, así que la llamas desde la sesión ya iniciada y le pasas dos parámetros, A y B, con los valores uno y siete. El cliente devuelve el resultado para mostrarlo en pantalla [4:20].

Un detalle importante: no agregas prompts porque el servidor no los tiene. Solo enlistas lo que realmente existe.

¿Por qué no necesitas ejecutar el servidor por separado?

Aquí viene lo interesante. Para probar todo, abres una nueva terminal, te mueves a la carpeta clase cinco y ejecutas python3 client.py.

No necesitas levantar el servidor manualmente. El cliente tiene la capacidad de levantar al servidor por sí mismo, así que basta con ejecutar el cliente [5:30].

Al presionar Enter ves el resultado: el listado de recursos, el listado de herramientas con add disponible, y la ejecución de esa herramienta.

¿Por qué el servidor devuelve un formato raro en vez de solo el número? Porque el servidor no habla humano. Sí ejecuta la operación, pero responde en un formato técnico. Si sumas uno y siete, el resultado real es ocho, pero viene envuelto en estructura adicional.

Como usuario final, a ti solo te interesa ese ocho. Y justamente para eso existe el cliente: para traducir esa respuesta cruda en algo útil.

¿Qué logras con esta interacción cliente-servidor?

Esta conexión entre las dos partes de un todo es lo que hace funcionar el protocolo.

Gracias a ella puedes:

  • Establecer la comunicación de un cliente con el servidor.
  • Enlistar los recursos a los que el cliente puede acceder.
  • Ejecutar herramientas y recibir resultados.

¿Qué sigue después de conectar cliente y servidor? Poner un host al frente. Cuando agregas ese host, el resultado se muestra en combinación con el cliente de una forma mucho más visible para los usuarios.

Y así el servidor deja de ser un componente aislado para convertirse en algo consumible. ¿Ya probaste ejecutar tu propio client.py? Cuéntame en los comentarios qué resultado te devolvió.