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.

MCP-Client-Tests — request and response sequence Sequence diagram for MCP client testing: GET /auth/v1/oauth/protected-resource answers 200 OK. POST /mcp/v1/mcp answers 202 Accepted. POST /identity/v1/resource answers 400 Bad Request. POST /mcp/v1/secure/mcp answers 401 Unauthorized. Your client Fun API Playground GET /auth/v1/oauth/protected-resource 200 OK A resource protected by a token from this flow (not the s… POST /mcp/v1/mcp 202 Accepted Streamable HTTP endpoint (JSON responses): initialize, to… POST /identity/v1/resource 400 Bad Request Ein nicht abgelaufenes Access-Token prüfen POST /mcp/v1/secure/mcp 401 Unauthorized Same server behind a Bearer token (mcp-test-token) — test…
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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

APIs, um es auszuprobieren

Betroffene Statuscodes

Andere Techniken

Einstiegsanleitung · Alle 55 Mock-REST-APIs

Zuletzt aktualisiert