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 qu'un serveur MCP fournit. Lorsque vous avez besoin d'utiliser une fonctionnalité externe, le client gère tout le passage de messages et les détails du protocole pour vous.

Communication agnostique au transport

L'une des forces clés de MCP est d'être agnostique au transport - une façon élégante de dire que le client et le serveur peuvent se parler 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 exécuté 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 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 avec lesquels vous travaillerez sont :

Le client MCP de notre serveur envoie ListToolsRequest à un serveur MCP GitHub, qui répond avec ListToolsResult.

ListToolsRequest/ListToolsResult : Le client demande au serveur « quels outils fournissez-vous ? » et obtient en retour une liste complète des fonctionnalités disponibles.

Notre serveur héberge le client MCP, qui envoie une CallToolRequest à un serveur MCP pour GitHub et obtient en retour un CallToolResult.

CallToolRequest/CallToolResult : Le client dit au serveur « exécute cet outil spécifique avec ces arguments » et reçoit les résultats de l'exécution.

Exemple de flux complet

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

Diagramme de séquence : utilisateur, notre serveur, client MCP, serveur MCP, GitHub et Claude, avec la flèche de la question de l'utilisateur vers notre serveur.

Le processus commence lorsqu'un utilisateur soumet sa question à votre serveur. Mais avant que votre serveur ne puisse demander de l'aide à Claude, il doit savoir quels outils sont disponibles.

Diagramme de séquence : notre serveur indique au client MCP qu'il a besoin d'outils pour Claude, puis ListToolsRequest et ListToolsResult.

Votre serveur demande au client MCP une liste d'outils. Le client envoie une ListToolsRequest au serveur MCP et obtient en retour un ListToolsResult avec tous les outils disponibles.

Diagramme de séquence de l'échange de la liste d'outils, ajoutant maintenant une flèche intitulée « Requête + Outils » de notre serveur vers Claude.

Maintenant votre serveur dispose de tout ce qui est nécessaire pour faire la requête initiale à Claude : la question de l'utilisateur plus la liste des outils disponibles.

Diagramme de séquence : après l'échange de la liste d'outils, notre serveur envoie « Requête + Outils » à Claude, qui répond « ToolUse ».

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

Diagramme de séquence du flux jusqu'à présent, ajoutant maintenant notre serveur disant au client MCP « Veuillez exécuter cet outil avec ces arguments ».

Votre serveur reconnaît que Claude souhaite exécuter un outil, mais votre serveur n'exécute plus les outils directement - c'est le travail du serveur MCP. Il demande donc au client MCP d'exécuter l'outil avec les arguments spécifiés par Claude.

Diagramme de séquence du flux à travers une CallToolRequest du client MCP vers le serveur MCP, puis sa requête vers GitHub.

Le client MCP envoie une CallToolRequest au serveur MCP, qui fait ensuite la requête réelle à GitHub pour récupérer les dépôts de l'utilisateur.

Diagramme de séquence des messages entre l'utilisateur, notre serveur, le client MCP, le serveur MCP, Claude et GitHub, jusqu'au résultat de l'outil.

GitHub répond avec les données du dépôt, que le serveur MCP enveloppe dans un CallToolResult et renvoie au client MCP.

Diagramme de séquence du flux complet de l'utilisateur à GitHub, ajoutant maintenant un message toolResult de notre serveur vers Claude.

Le client MCP transmet le résultat de l'outil à votre serveur, qui l'envoie ensuite à Claude dans le cadre d'un message de suivi.

Diagramme de séquence de l'ensemble du flux entre l'utilisateur, notre serveur, le client MCP, le serveur MCP, Claude et GitHub, décrit ci-dessus.

Enfin, Claude dispose de toutes les informations dont il a besoin et formule une réponse comme « Vos dépôts sont... » qui est renvoyée via votre serveur à l'utilisateur.

Diagramme de séquence de l'ensemble du flux entre l'utilisateur, notre serveur, le client MCP, le serveur MCP, Claude et GitHub, décrit ci-dessus.

Oui, ce flux comporte de nombreuses étapes, mais chaque composant a une responsabilité claire. Le client MCP fait abstraction de la complexité de la communication avec le serveur, vous permettant de vous concentrer sur la construction de la logique de votre application tout en ayant accès à des outils et services externes puissants.