Chargement
Chargement

Le client MCP sert de pont de communication entre votre serveur et les serveurs MCP. Considérez-le comme votre point d'accès à tous les outils fournis par un serveur MCP. Lorsque vous avez besoin d'utiliser des outils ou des services externes, le client gère pour vous tout le passage de messages et les détails du protocole.

Communication agnostique au transport

L'une des principales forces de MCP est d'être agnostique au transport - une façon élégante de dire que le client et le serveur peuvent communiquer entre eux en utilisant différentes méthodes de communication. La configuration la plus courante exécute à la fois le client MCP et le serveur sur la même machine, où ils communiquent via l'entrée/sortie standard.

Notre serveur héberge le client MCP, qui communique dans les deux sens via l'entrée/sortie standard avec un serveur MCP GitHub fonctionnant localement.

Mais vous n'êtes pas limité à cette approche. Les clients et serveurs MCP peuvent également se connecter via :

  • HTTP
  • WebSockets
  • Divers autres protocoles réseau

Notre serveur contient le client MCP, qui communique dans les deux sens avec un serveur MCP distinct pour GitHub via WebSockets.

Types de messages

Une fois connectés, le client et le serveur échangent des types de messages spécifiques définis dans la spécification MCP. Les principaux types de messages avec lesquels vous travaillerez sont :

Notre client MCP envoie une ListToolsRequest à un serveur MCP pour GitHub, qui répond avec un ListToolsResult de ses outils.

ListToolsRequest/ListToolsResult : Le client demande au serveur « quels outils fournissez-vous ? » et reçoit en retour une liste des outils disponibles.

Notre client MCP envoie une ListToolsRequest à un serveur MCP pour GitHub, qui répond avec un ListToolsResult de ses outils.

CallToolRequest/CallToolResult : Le client demande au serveur d'exécuter un outil spécifique avec certains arguments, puis reçoit les résultats.

Le client MCP de notre serveur envoie une CallToolRequest au serveur MCP pour GitHub, qui renvoie un CallToolResult.

Exemple de flux complet

Voici comment toutes ces pièces fonctionnent ensemble dans un scénario réel. Supposons qu'un utilisateur demande « Quels dépôts ai-je ? » - voici le flux de communication complet :

Diagramme de flux avec des colonnes pour l'utilisateur, notre serveur, le client MCP, le serveur MCP, GitHub et Claude, sans aucun message pour l'instant.

Le processus commence lorsqu'un utilisateur soumet une requête à votre serveur. Votre serveur se rend compte qu'il doit fournir à Claude une liste des outils disponibles avant d'effectuer la demande.

Diagramme de séquence dont la seule flèche jusqu'à présent va de l'utilisateur à notre serveur, demandant « Quels dépôts ai-je ? ».

Votre serveur demande au client MCP la liste des outils, qui envoie une ListToolsRequest au serveur MCP et reçoit en retour un ListToolsResult.

Diagramme de séquence : notre serveur indique au client MCP « J'ai besoin d'une liste d'outils à envoyer à Claude », qui interroge le serveur MCP.

Maintenant, votre serveur dispose de tout ce dont il a besoin pour effectuer la demande initiale à Claude - à la fois la question de l'utilisateur et les outils disponibles.

Dans le diagramme de séquence, notre serveur envoie la requête et les outils à Claude en une seule étape intitulée « Requête + Outils ».

Claude examine les outils et décide qu'il doit en appeler un pour répondre à la question. Il répond avec une demande d'utilisation d'outil.

Diagramme de flux : après le ToolUse de Claude, notre serveur indique au client MCP « Veuillez exécuter cet outil avec ces arguments ».

Votre serveur demande au client MCP d'exécuter l'outil demandé par Claude. Le client MCP envoie une CallToolRequest au serveur MCP, qui effectue ensuite la demande réelle à GitHub.

Diagramme de séquence sur six couloirs de l'Utilisateur à GitHub, se terminant par la CallToolRequest et la demande du serveur MCP à GitHub.

GitHub renvoie les données des dépôts, qui remontent via le serveur MCP sous forme de CallToolResult, puis vers le client MCP, et enfin vers votre serveur.

Diagramme de séquence de la requête sur les dépôts, qui ajoute désormais un message toolResult envoyé de notre serveur à Claude.

Votre serveur renvoie les résultats de l'outil à Claude dans un message de suivi. Claude dispose désormais de toutes les informations nécessaires pour formuler une réponse complète.

Diagramme de séquence complet se terminant par la réponse de Claude commençant par « Vos dépôts sont » et transitant par votre serveur jusqu'à l'utilisateur.

Enfin, Claude répond avec la réponse formatée, que votre serveur transmet à l'utilisateur.

Oui, ce flux comporte de nombreuses étapes, mais chaque composant a une responsabilité claire. Le client MCP abstrait la complexité de la communication avec le serveur, vous permettant de vous concentrer sur la construction de la logique de votre application. Lorsque nous implémenterons notre propre client et serveur MCP, vous verrez comment chaque élément s'imbrique en pratique.