Müfredat 250 dersinden 139. · Yapılandırılmış Çıktılar ve Fonksiyon/Araç Çağırma
Yapılandırılmış Çıktılar ve Fonksiyon/Araç Çağırma

MCP (Model Context Protocol) üzerinde araçlar

Uygulaman birden fazla araç içerdiğinde, her model sağlayıcısı onları çağırmak için kendi JSON yapısını icat eder ve sen her sağlayıcı için bir adapter yazmak zorunda kalırsın. Model Context Protocol (MCP) bunu çözen açık standarttır. Bu, herhangi bir model istemcisine tools (modelin çağırabileceği fonksiyonlar), resources (okuyabileceği veriler) ve prompts sunmak için kullanılan bir JSON-RPC 2.0 kablo protokolüdür. Bir kez MCP server yaz ve herhangi bir MCP uyumlu istemci (bir IDE asistanı, bir masaüstü uygulaması, bir agent) onu kullanabilsin.

Her mesaj JSON-RPC 2.0, yani küçük ve sabit bir zarftır. Bir request her zaman dört anahtar taşır:

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "add", "arguments": {"a": 2, "b": 3}}}

id bir yanıtı isteğine bağlar. Sunucu aynı id değerini yansıtan ve either bir result or bir error nesnesi taşıyan, asla ikisini birden içermeyen bir response ile cevap verir:

{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}

Negatif kodlar standart JSON-RPC'dir: -32601 "method not found", -32602 "invalid params" ve benzeridir. Bir tools/call sonucu her zaman şu şekildedir: bir content blok listesi (metin, görseller vb.) artı isError. Çalışan ama başarısız olan (örneğin hatalı bir şehir adı) bir araç, modelin hatayı okuyabilmesi için normal bir sonuçta isError: true ile yanıt verir; JSON-RPC error nesnesi ise bilinmeyen bir yöntem gibi protokol sorunları içindir.

A oturumu bir handshake ile başlar: istemci bir initialize isteği gönderir (protokol sürümü, yetenekleri ve adı), sunucu kendi yetenekleriyle cevap verir ve istemci bir notifications/initialized bildirimiyle onaylar (içinde id olmayan bir mesaj, çünkü kimse ona cevap vermez). Ancak o zaman istemci boş parametrelerle tools/list çağırarak araçları discover yapar; sunucu araç tanımlayıcılarının listesini döndürür.

gerçek bir MCP sunucusu stdio veya HTTP üzerinden çalışır ve bunu SDK'ya bağlar; burada mesajları standart kütüphane json modülü ile oluşturup ayrıştırıyoruz böylece iletim formatı somut oluyor. Üç fonksiyon yazıyorsun.

  • build_request(id, method, params) -> string {"jsonrpc": "2.0", "id": id, "method": method, "params": params} için bir JSON. json.dumps.
  • kullan.
  • parse_response(text) -> json.loads metnini, jsonrpc == "2.0" gerektirir (aksi halde ValueError fırlat). Eğer bir result varsa, {"id": ..., "ok": True, "result": ...} döndür. Eğer bir error varsa, {"id": ..., "ok": False, "error": {"code": ..., "message": ...}} döndür. Eğer ikisi de yoksa, ValueError fırlat.
  • list_tools_request(id) -> araç keşif isteği: "tools/list" metodu ve boş params içeren bir build_request {}.

Çünkü build_request bir string döndürdüğü için, testler bunu json.loads ile tekrar ayrıştırıp sözlüğü karşılaştırıyor, bu yüzden anahtar sırası önemli değil. Bir sonucun ve bir hatanın her ikisinin de gidip geri geldiğinden, discovery isteğinin doğru metoda sahip olduğundan ve jsonrpc eksik olan veya ne result ne de error içeren bir mesajın hata verdiğinden emin ol.

Senin sıran

json modülü ile MCP tarzı JSON-RPC 2.0 mesajları oluştur ve bunları ayrıştır. build_request(id, method, params), {"jsonrpc": "2.0", "id", "method", "params"} için JSON dizisini döndürür. parse_response(text) metni yükler, jsonrpc == "2.0" gerektirir (aksi halde ValueError fırlatır) ve bir sonuç için {"id", "ok": True, "result"} veya bir hata için {"id", "ok": False, "error": {"code", "message"}} döndürür, ikisi de yoksa hata fırlatır. list_tools_request(id), boş parametrelerle tools/list keşif isteğini (el sıkışmadan sonra gönderilir) döndürür.

Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor

Bu alıştırma yakında açılacak

Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.