Cargando
Cargando

El cliente MCP funciona como el puente de comunicación entre tu servidor y los servidores MCP. Piensa en él como tu punto de acceso a todas las herramientas que ofrece un servidor MCP. Cuando necesitas usar funcionalidad externa, el cliente se encarga de todo el paso de mensajes y los detalles del protocolo por ti.

Comunicación agnóstica al transporte

Una de las principales fortalezas de MCP es ser agnóstico al transporte, una forma elegante de decir que el cliente y el servidor pueden comunicarse entre sí usando diferentes métodos de comunicación. La configuración más común ejecuta tanto el cliente MCP como el servidor en la misma máquina, donde se comunican a través de entrada/salida estándar.

Nuestro servidor contiene el cliente MCP, que se comunica en ambas direcciones a través de entrada/salida estándar con un servidor MCP de GitHub que se ejecuta localmente.

Pero no te limitas a ese enfoque. Los clientes y servidores MCP también pueden conectarse a través de:

  • HTTP
  • WebSockets
  • Varios otros protocolos de red

Nuestro servidor contiene el cliente MCP, que se comunica en ambas direcciones con un servidor MCP de GitHub a través de WebSockets.

Tipos de mensajes

Una vez conectados, el cliente y el servidor intercambian tipos de mensajes específicos definidos en la especificación de MCP. Los principales con los que trabajarás son:

El cliente MCP en nuestro servidor envía ListToolsRequest a un servidor MCP de GitHub, que responde con ListToolsResult.

ListToolsRequest/ListToolsResult: El cliente le pregunta al servidor "¿qué herramientas proporcionas?" y recibe una lista completa de la funcionalidad disponible.

El cliente MCP en nuestro servidor envía ListToolsRequest a un servidor MCP de GitHub, que responde con ListToolsResult.

CallToolRequest/CallToolResult: El cliente le dice al servidor "ejecuta esta herramienta específica con estos argumentos" y recibe los resultados de la ejecución.

Nuestro servidor contiene el cliente MCP, que envía un CallToolRequest a un servidor MCP de GitHub y recibe de vuelta un CallToolResult.

Flujo de ejemplo del mundo real

Repasemos un ejemplo completo para ver cómo encajan todas estas piezas juntas. Imagina que un usuario pregunta "¿Qué repositorios tengo?": aquí está toda la cadena de comunicación:

Líneas de vida del diagrama de secuencia para el usuario, nuestro servidor, el cliente MCP, el servidor MCP, GitHub y Claude, antes de cualquier mensaje.

El proceso comienza cuando un usuario envía su pregunta a tu servidor. Tu servidor se da cuenta de que necesita proporcionarle a Claude las herramientas disponibles antes de hacer la solicitud a la IA.

Diagrama de secuencia: usuario, nuestro servidor, cliente MCP, servidor MCP, GitHub y Claude, con la flecha de la pregunta del usuario hacia nuestro servidor.

Tu servidor le pide al cliente MCP una lista de herramientas, lo que desencadena un ListToolsRequest hacia el servidor MCP. El servidor responde con ListToolsResult, que contiene todas las herramientas disponibles.

Diagrama de secuencia: nuestro servidor le dice al cliente MCP que necesita herramientas para Claude, luego ListToolsRequest y ListToolsResult.

Ahora tu servidor tiene todo lo necesario para hacer la solicitud inicial a Claude: la pregunta del usuario más las herramientas disponibles. Claude analiza las herramientas y decide que necesita llamar a una para responder la pregunta correctamente.

Diagrama de secuencia del intercambio de la lista de herramientas, ahora añadiendo una flecha etiquetada "Query + Tools" desde nuestro servidor hacia Claude.

Claude responde con una solicitud de uso de herramienta. Tu servidor reconoce esto y le pide al cliente MCP que ejecute la herramienta con los argumentos especificados por Claude.

Diagrama de secuencia: después del intercambio de la lista de herramientas, nuestro servidor envía "Query + Tools" a Claude, que responde "ToolUse".

El cliente MCP envía un CallToolRequest al servidor MCP, que luego hace la llamada real a la API de GitHub para obtener los repositorios del usuario.

Diagrama de secuencia del flujo a través de un CallToolRequest desde el cliente MCP hacia el servidor MCP, y luego su solicitud a GitHub.

GitHub devuelve los datos del repositorio, que el servidor MCP envuelve en un CallToolResult y envía de vuelta a través de la cadena. Tu servidor recibe estos datos y ahora puede hacer una solicitud de seguimiento a Claude.

Diagrama de secuencia de los mensajes entre el usuario, nuestro servidor, el cliente MCP, el servidor MCP, Claude y GitHub, hasta el resultado de la herramienta.

El último paso envía los resultados de la herramienta a Claude como parte de un mensaje del usuario. Claude ahora tiene toda la información necesaria para formular una respuesta completa sobre los repositorios del usuario.

Diagrama de secuencia de todo el flujo entre el usuario, nuestro servidor, el cliente MCP, el servidor MCP, Claude y GitHub, descrito anteriormente.

Sí, este flujo involucra muchos pasos, pero entenderlo te prepara para implementar tus propios clientes y servidores MCP. Cada componente tiene un rol específico, y los tipos de mensajes estandarizados garantizan que todo funcione en conjunto sin problemas, independientemente del mecanismo de transporte subyacente.