Cargando
Cargando

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

Comunicación agnóstica de transporte

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

Nuestro servidor aloja el cliente MCP, comunicándose en ambas direcciones a través de la entrada/salida estándar con un servidor MCP de GitHub ejecutándose localmente.

Pero no estás limitado a ese enfoque. Los clientes y servidores MCP también pueden conectarse mediante:

  • HTTP
  • WebSockets
  • Varios otros protocolos de red

Nuestro servidor contiene el cliente MCP, que se comunica en ambas direcciones con un servidor MCP para 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 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 a cambio una lista completa de la funcionalidad disponible.

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

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

Ejemplo de flujo completo

Así es como todas las piezas funcionan juntas en un escenario real. Supongamos que un usuario pregunta "¿Qué repositorios tengo?"; aquí está el flujo de comunicación completo:

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

El proceso comienza cuando un usuario envía su pregunta a tu servidor. Pero antes de que tu servidor pueda pedirle ayuda a Claude, necesita saber qué herramientas hay disponibles.

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

Tu servidor le pide al cliente MCP una lista de herramientas. El cliente envía una ListToolsRequest al servidor MCP y recibe a cambio un ListToolsResult con todas las herramientas disponibles.

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

Ahora tu servidor tiene todo lo necesario para hacer la solicitud inicial a Claude: la pregunta del usuario más la lista de herramientas disponibles.

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

Claude analiza las herramientas y decide que necesita llamar a una para responder la pregunta. Responde con una solicitud de uso de herramientas.

Diagrama de secuencia del flujo hasta ahora, ahora agregando que nuestro servidor le dice al cliente MCP "Por favor ejecuta esta herramienta con estos argumentos".

Tu servidor reconoce que Claude quiere ejecutar una herramienta, pero tu servidor ya no ejecuta herramientas directamente; ese es el trabajo del servidor MCP. Así que le pide al cliente MCP que ejecute la herramienta con los argumentos especificados por Claude.

Diagrama de secuencia del flujo a través de una CallToolRequest del cliente MCP al servidor MCP, luego su solicitud a GitHub.

El cliente MCP envía una CallToolRequest al servidor MCP, que luego hace la solicitud real a GitHub para obtener los repositorios del usuario.

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

GitHub responde con los datos del repositorio, que el servidor MCP envuelve en un CallToolResult y envía de vuelta al cliente MCP.

Diagrama de secuencia del flujo completo desde el usuario hasta GitHub, ahora agregando un mensaje toolResult de nuestro servidor a Claude.

El cliente MCP pasa el resultado de la herramienta de vuelta a tu servidor, que luego lo envía a Claude como parte de un mensaje de seguimiento.

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

Finalmente, Claude tiene toda la información que necesita y formula una respuesta como "Tus repositorios son..." que se envía de vuelta a través de tu servidor hasta el usuario.

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

Sí, este flujo implica muchos pasos, pero cada componente tiene una responsabilidad clara. El cliente MCP abstrae la complejidad de la comunicación con el servidor, permitiéndote enfocarte en construir la lógica de tu aplicación mientras sigues teniendo acceso a herramientas y servicios externos potentes.