MCP istemcilerini bir Model Context Protocol sunucusuna karşı test etmek

Bir Model Context Protocol istemcisinin ele alması gereken iki tür hata vardır ve bunları karıştırmak yaygın bir hatadır: çalışıp başarısız olan, modelin görüp üzerine düşünmesi gereken bir araç ve istemcinin kendisinin ele alması gereken bir JSON-RPC hatası. MCP Test Server, bir MCP istemcisinin pratikte karşılaştığı oturum, şema, kaynak ve kimlik doğrulama davranışlarıyla birlikte ikisini de istek üzerine üretir; böylece bir istemci ya da ajan, sürekli değişen bir sunucu yerine bilinen bir sunucuya karşı test edilebilir.

MCP istemci testi — 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 Tamam 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 Süresi dolmamış bir erişim token'ını doğrula POST /mcp/v1/secure/mcp 401 Unauthorized Same server behind a Bearer token (mcp-test-token) — test…
Katalogdaki gerçek uç noktalar — yukarıdaki her istek karşılanıyor ve gösterilen her durum kodu, o uç noktanın gerçekten döndürdüğü bir koddur.

Bunu nasıl uygulayabilirsiniz?

  1. initialize çağrısını yapın ve anlaşılan protokol sürümünü, sunucu yeteneklerini ve yanıtın bir Mcp-Session-Id başlığı taşıdığını doğrulayın.
  2. Araçları listeleyin, add aracını çağırın ve hem metin içeriğinin hem de structuredContent alanının aracın tanımlı çıktı şemasıyla uyuştuğunu doğrulayın.
  3. fail aracını mode "tool" ve mode "protocol" ile çağırın ve istemcinizin ilkini modele ilettiğini, ikincisini ise kendisinin ele aldığını kontrol edin.
  4. Bir aracı yanlış türde bir argümanla çağırın ve JSON-RPC -32602 hatasının kullanıcıya açık bir mesaj olarak ulaştığını doğrulayın.
  5. Güvenli uç noktaya token olmadan bağlanın, 401 yanıtını ve WWW-Authenticate başlığını okuyun, ardından belgelenmiş test token'ıyla yeniden deneyin.

Denemek için API'ler

İlgili durum kodları

Diğer teknikler

Başlangıç rehberi · 55 mock REST API’nin tamamı

Son güncelleme