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 proporciona un servidor MCP. Cuando necesitas usar herramientas o servicios externos, 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 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 a través de:

  • HTTP
  • WebSockets
  • Varios otros protocolos de red

Nuestro servidor contiene el cliente MCP, el cual se comunica en ambas direcciones con un servidor MCP independiente 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 de MCP. Los principales tipos de mensajes con los que trabajarás son:

Nuestro cliente MCP envía una ListToolsRequest a un servidor MCP para GitHub, el cual responde con un ListToolsResult de sus herramientas.

ListToolsRequest/ListToolsResult: El cliente le pregunta al servidor "¿qué herramientas proporcionas?" y recibe a cambio una lista de herramientas disponibles.

Nuestro cliente MCP envía una ListToolsRequest a un servidor MCP para GitHub, el cual responde con un ListToolsResult de sus herramientas.

CallToolRequest/CallToolResult: El cliente le pide al servidor que ejecute una herramienta específica con ciertos argumentos, y luego recibe los resultados.

El cliente MCP de nuestro servidor envía una CallToolRequest al servidor MCP para GitHub, el cual devuelve un CallToolResult.

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 flujo con columnas para el usuario, nuestro servidor, el cliente MCP, el servidor MCP, GitHub y Claude, sin mensajes todavía.

El proceso comienza cuando un usuario envía una consulta a tu servidor. Tu servidor se da cuenta de que necesita proporcionar a Claude una lista de herramientas disponibles antes de realizar la solicitud.

Diagrama de secuencia cuya única flecha hasta ahora va del usuario a nuestro servidor, preguntando "¿Qué repositorios tengo?".

Tu servidor le pide herramientas al cliente MCP, el cual envía una ListToolsRequest al servidor MCP y recibe de vuelta un ListToolsResult.

Diagrama de secuencia: nuestro servidor le dice al cliente MCP "Necesito una lista de herramientas para enviar a Claude", quien le pregunta al servidor MCP.

Ahora tu servidor tiene todo lo necesario para hacer la solicitud inicial a Claude - tanto la pregunta del usuario como las herramientas disponibles.

En el diagrama de secuencia, nuestro servidor envía la consulta y las herramientas a Claude en un solo paso etiquetado "Consulta + Herramientas".

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

Diagrama de flujo: después del ToolUse de Claude, nuestro servidor le dice al cliente MCP "Por favor ejecuta esta herramienta con estos argumentos".

Tu servidor le pide al cliente MCP que ejecute la herramienta que Claude solicitó. El cliente MCP envía una CallToolRequest al servidor MCP, el cual entonces hace la solicitud real a GitHub.

Diagrama de secuencia a través de seis carriles desde el Usuario hasta GitHub, terminando con CallToolRequest y la solicitud del servidor MCP a GitHub.

GitHub devuelve los datos del repositorio, los cuales fluyen de vuelta a través del servidor MCP como un CallToolResult, luego al cliente MCP, y finalmente a tu servidor.

Diagrama de secuencia de la consulta del repositorio, el cual ahora agrega un mensaje toolResult enviado desde nuestro servidor a Claude.

Tu servidor envía los resultados de la herramienta de vuelta a Claude en un mensaje de seguimiento. Claude ahora tiene toda la información que necesita para formular una respuesta completa.

Diagrama de secuencia completo que termina con la respuesta de Claude comenzando con "Tus repositorios son" pasando a través de tu servidor hacia el usuario.

Finalmente, Claude responde con la respuesta formateada, la cual tu servidor devuelve al usuario.

Sí, este flujo involucra 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. A medida que implementemos nuestro propio cliente y servidor MCP, verás cómo encaja cada pieza en la práctica.