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.
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?
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.
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.
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.
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.
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.
Sayfalama testi — Sayfa numarası ve imleçle sayfalama uygulamalarını ve istemcileri bozan uç durumları (son kısmi sayfa, aralık dışı sayfa ve topladığınız verilerle uyuşmayan toplam sayı) pratik yapın.
Hız sınırlama testi — Retry-After ve X-RateLimit başlıklarıyla gerçek bir 429 hatası tetikleyin ve istemcinizin doğrudan sınıra kadar yeniden denemek yerine geri çekildiğini doğrulayın.
İdempotans anahtar testi — Aynı yazma işlemini bir Idempotency-Key ile iki kez gönderin ve işlemin bir kez gerçekleştiğini doğrulayın; bu mekanizma, ağ üzerinden tekrar deneme işleminin mükerrer ücretlendirmeye dönüşmesini engeller.
ETag ve If-Match testleri — Eski bir ETag ile yazarak 412 Önkoşul Başarısız hatasına neden olun; bu, iki istemcinin birbirinin üzerine sessizce yazmasını engelleyen kontrol mekanizmasıdır.
Webhook imza testi — Bir geri çağırma işlemi kaydedin, bir teslimatı tetikleyin, HMAC imzasını doğrulayın ve değiştirilmiş bir veri paketinin reddedildiğini onaylayın.
OAuth ve JWT testleri — Gerçek istemci kimlik bilgileri, yetkilendirme kodu ve cihaz kodu akışlarını çalıştırın, ardından oturum ortasında belirtecin süresi dolduğunda istemcinizin ne yaptığını test edin.
Negatif test — 400, 401, 403, 404, 409, 418, 422, 429, 500 ve 503 numaralı kodları kasıtlı olarak tetikleyin ve müşterinizin her birine farklı şekilde yanıt verip vermediğini kontrol edin.
Asenkron iş testi — Uzun süreli bir iş başlatın, 202 olayını ve Location başlığını takip edin ve tamamlanana kadar (başarısızlık ve zaman aşımı yolları da dahil olmak üzere) sorgulama yapın.
LLM API testi — Bir dil modelini çağıran kodu gerçek bir anahtar olmadan test edin: akışla gelen yanıtı birleştirin, kesilen akışı yakalayın, Retry-After'a uyun ve araç çağrısı döngüsünü tamamlayın.