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 pour vous tout le passage de messages et les détails du protocole.

Communication indépendante du transport

L'une des principales forces de MCP est son indépendance vis-à-vis du 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 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.

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

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

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

Exemple de flux concret

Parcourons un exemple complet pour voir comment tous ces éléments fonctionnent ensemble. Imaginez qu'un utilisateur demande « Quels dépôts ai-je ? » - voici l'ensemble de la chaîne de communication :

Lignes de vie du diagramme de séquence pour l'utilisateur, notre serveur, le client MCP, le serveur MCP, GitHub et Claude, avant tout message.

Le processus commence lorsqu'un utilisateur soumet sa question à votre serveur. Votre serveur se rend compte qu'il doit fournir à Claude les outils disponibles avant de faire la requête à l'IA.

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.

Votre serveur demande au client MCP une liste d'outils, ce qui déclenche une ListToolsRequest vers le serveur MCP. Le serveur répond avec ListToolsResult contenant tous les outils 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 dispose maintenant de tout ce qu'il faut pour effectuer la requête initiale à Claude : la question de l'utilisateur ainsi que les outils disponibles. Claude analyse les outils et décide qu'il doit en appeler un pour répondre correctement à la question.

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.

Claude répond avec une demande d'utilisation d'outil. Votre serveur reconnaît cela et demande au client MCP d'exécuter l'outil avec les arguments spécifiés par Claude.

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

Le client MCP envoie une CallToolRequest au serveur MCP, qui effectue alors l'appel API réel à GitHub pour récupérer les dépôts de l'utilisateur.

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

GitHub renvoie les données des dépôts, que le serveur MCP intègre dans un CallToolResult et renvoie à travers la chaîne. Votre serveur reçoit ces données et peut maintenant effectuer une requête de suivi vers Claude.

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.

La dernière étape envoie les résultats de l'outil à Claude dans le cadre d'un message utilisateur. Claude dispose désormais de toutes les informations nécessaires pour formuler une réponse complète concernant les dépôts de 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 le comprendre vous prépare à implémenter vos propres clients et serveurs MCP. Chaque composant a un rôle spécifique, et les types de messages standardisés garantissent que tout fonctionne ensemble de manière fluide, quel que soit le mécanisme de transport sous-jacent.