đŹđ§ 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 fluxGET.
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 :
- Démarrez votre serveur (Streamable HTTP, par exemple
http://127.0.0.1:3001/mcp). npx @modelcontextprotocol/inspector, ouvrez l'URL affichée, choisissez le transport Streamable HTTP, saisissez l'URL.- Connectez-vous, puis listez outils, ressources et prompts. Comparez avec ce que
orkeon run --list-toolsaffiche pour la mĂȘme entrĂ©eMCP:Servers. - Dans le volet History, vĂ©rifiez les en-tĂȘtes des POST :
Mcp-Session-Idest renvoyĂ© aprĂšsinitialize, une requĂȘte rĂ©pondue404fait 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.