MCP-Clients gegen einen Model-Context-Protocol-Server testen
Ein Model-Context-Protocol-Client muss zwei Arten von Fehlern behandeln, und sie zu verwechseln ist der typische Bug: ein Tool, das lief und scheiterte, was das Modell sehen und berücksichtigen soll, und ein JSON-RPC-Fehler, den der Client selbst behandeln muss. Der MCP Test Server erzeugt beides auf Anfrage, zusammen mit dem Session-, Schema-, Ressourcen- und Authentifizierungsverhalten, dem ein MCP-Client in der Praxis begegnet – so lässt sich ein Client oder Agent gegen einen bekannten statt einen sich ständig ändernden Server testen.
Echte Endpunkte aus dem Katalog – jede der oben genannten Anfragen wird bedient, und jeder angezeigte Statuscode ist ein Statuscode, den dieser Endpunkt tatsächlich zurückgibt.
Wie man es übt
Führen Sie initialize aus und prüfen Sie die ausgehandelte Protokollversion, die Server-Capabilities und dass die Antwort einen Mcp-Session-Id-Header trägt.
Listen Sie die Tools auf, rufen Sie add auf und prüfen Sie, dass sowohl der Textinhalt als auch structuredContent dem deklarierten Ausgabeschema des Tools entsprechen.
Rufen Sie fail mit mode "tool" und mit mode "protocol" auf und prüfen Sie, dass Ihr Client den ersten Fall an das Modell weitergibt und den zweiten selbst behandelt.
Rufen Sie ein Tool mit einem Argument des falschen Typs auf und prüfen Sie, dass der JSON-RPC-Fehler -32602 den Nutzer als verständliche Meldung erreicht.
Verbinden Sie sich ohne Token mit dem gesicherten Endpunkt, lesen Sie den 401 und seinen WWW-Authenticate-Header und wiederholen Sie es mit dem dokumentierten Test-Token.
API-Paginierung testen — Üben Sie die Seitennummerierung und die Cursornavigation sowie die Sonderfälle, die bei Clients zu Problemen führen können: die letzte unvollständige Seite, eine Seite außerhalb des gültigen Bereichs und eine Gesamtzahl, die nicht mit den von Ihnen erfassten Daten übereinstimmt.
API-Ratenbegrenzung testen — Lösen Sie einen echten 429-Fehler mit Retry-After- und X-RateLimit-Headern aus und überprüfen Sie, ob Ihr Client einen Rücksetzer auslöst, anstatt direkt bis zum Limit zu wiederholen.
Idempotenz-Schlüsseltest — Senden Sie denselben Schreibvorgang zweimal mit einem Idempotenzschlüssel und bestätigen Sie, dass die Operation einmal ausgeführt wird – der Mechanismus, der verhindert, dass ein erneuter Netzwerkversuch zu einer doppelten Belastung führt.
ETag- und If-Match-Test — Ein 412-Fehler (Vorbedingung fehlgeschlagen) wird durch Schreiben mit einem veralteten ETag ausgelöst – die Überprüfung, die verhindert, dass zwei Clients sich gegenseitig stillschweigend überschreiben.
Webhook-Signaturprüfung — Registrieren Sie einen Rückruf, lösen Sie eine Zustellung aus, überprüfen Sie die HMAC-Signatur und bestätigen Sie, dass eine manipulierte Nutzlast abgelehnt wird.
OAuth- und JWT-Tests — Führen Sie echte Client-Anmeldeinformationen, Autorisierungscodes und Gerätecodes durch und testen Sie dann, was Ihr Client tut, wenn das Token während der Sitzung abläuft.
Negativer Test — Provozieren Sie absichtlich die Fehler 400, 401, 403, 404, 409, 418, 422, 429, 500 und 503 und prüfen Sie, ob Ihr Client jeden einzelnen Fehler unterschiedlich behandelt.
Asynchrone Jobtests — Starten Sie einen langlaufenden Job, folgen Sie dem Statuscode 202 und dessen Location-Header und überprüfen Sie den Status bis zum Abschluss – einschließlich der Fehler- und Timeout-Pfade.
LLM-API-Tests — Testen Sie Code, der ein Sprachmodell aufruft, ohne echten Schlüssel: gestreamte Antworten zusammensetzen, abgebrochene Streams erkennen, Retry-After beachten und einen Tool-Call durchspielen.