Table of Contents

🇬🇧 English version

Vérifier le client MCP contre le serveur de référence

Voir aussi : Intégration MCP · Limites connues · Whisper par MCP

Le client MCP est testé contre des doubles qui parlent le protocole, et contre le serveur de référence du projet MCP, @modelcontextprotocol/server-everything, qui expose des outils, des ressources, des prompts et des abonnements de ressource. Deux façons de le lancer : le test nocturne, et le MCP Inspector à la main.

Le test nocturne

McpReferenceServerInteropTests (tests/core/Orkeon.Infrastructure.Tests/MCP/, [Trait("Category", "Integration")]) démarre npx -y --prefer-offline @modelcontextprotocol/server-everything@2.2.1 une fois en stdio et une fois en Streamable HTTP (streamableHttp, sur un port loopback qu'il choisit), le connecte par McpToolProvider et vérifie :

  • les outils du serveur sont enregistrĂ©s (dont echo) ;
  • les prompts sont listĂ©s et l'un d'eux, sans argument, est obtenu ;
  • les ressources sont listĂ©es (toutes les pages suivies) et l'une est lue ;
  • une ressource abonnĂ©e est mise Ă  jour par le serveur (resources/updated), ce qui prouve que les notifications que le serveur envoie de lui-mĂȘme parviennent au client — en stdio par la sortie du processus, en HTTP par le flux GET.

integration.yml installe Node avec actions/setup-node aprÚs le nettoyage du disque du runner (ce nettoyage retire le npm du runner). Sans npx, le test est sauté sur un poste et échoue quand CI=true. Il télécharge le paquet : sur une connexion mesurée, lancez-le une fois avec le cache chaud (npx -y @modelcontextprotocol/server-everything@2.2.1 --help le remplit), puis en local :

dotnet test tests/core/Orkeon.Infrastructure.Tests/Orkeon.Infrastructure.Tests.csproj --no-build \
  --filter "FullyQualifiedName~McpReferenceServerInteropTests"

tools/list_changed n'a pas de déclencheur déterministe sur le serveur de référence : ce chemin est couvert par les faux serveurs (McpToolListChangedTests, McpSubscriptionTests).

À la main avec le MCP Inspector

Le MCP Inspector est l'interface de débogage du projet. Servez-vous-en pour voir ce que votre serveur envoie avant d'y pointer Orkeon :

  1. Démarrez votre serveur (Streamable HTTP, par exemple http://127.0.0.1:3001/mcp).
  2. npx @modelcontextprotocol/inspector, ouvrez l'URL affichée, choisissez le transport Streamable HTTP, saisissez l'URL.
  3. Connectez-vous, puis listez outils, ressources et prompts. Comparez avec ce que orkeon run --list-tools affiche pour la mĂȘme entrĂ©e MCP:Servers.
  4. Dans le volet History, vĂ©rifiez les en-tĂȘtes des POST : Mcp-Session-Id est renvoyĂ© aprĂšs initialize, une requĂȘte rĂ©pondue 404 fait rĂ©initialiser Orkeon.

Le transport qu'Orkeon ne parle pas est le HTTP+SSE de 2024-11-05, oĂč le serveur annonce un endpoint de messages sĂ©parĂ© : l'Inspector le propose sous « SSE » ; choisissez Streamable HTTP.