MCP Academy · Ders

İstemcinin Köklerini İsteme

İzin verilen çalışma dizinlerinin listesini isteyin.

2. ders / 413 adım

İstemcinin Köklerini İsteme, CoddyKit'te ücretsiz bir MCP Academy dersidir. Bu, 4 dersinin 2. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, MCP Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. MCP Academy kursu toplamda 4 dersten oluşur.

Şimdi Onları İsteyelim

Köklerin var olduğunu bilmek ilk adımdır. İkinci adım, sunucunuzun nereden okuyacağına veya nereye yazacağına karar verebilmesi için istemciden güncel listesini gerçekten istemektir. 📨

Sunucu İsteği Başlatır

Burada yön değişir: sunucunuz isteği gönderir ve istemci yanıtlar. Çağrılan yöntem, istemcinin o anda sunduğu her şeyi isteyen roots/list yöntemidir.

{ "method": "roots/list" }

Bağlam Üzerinden Köklere Ulaşın

Python SDK'sında ham JSON oluşturmazsınız. Aracınıza verilen ve istemciyle etkin oturumu saran istek bağlamı nesnesini kullanırsınız.

async def my_tool(ctx: Context):
    ...

Tek Bir Kolay Çağrı

Bu bağlamdan list_roots() çağrısını yapıp sonucunu beklersiniz. SDK sizin için roots/list isteğini gönderir ve istemcinin yanıtını türü belirlenmiş bir sonuç olarak döndürür.

result = await ctx.session.list_roots()

Geriye Ne Döner

Yanıt bir roots listesi içerir. Her öğede bir URI ve isteğe bağlı bir ad bulunur; bu, daha önce gördüğünüz küçük yapının aynısıdır ve öğeler üzerinde döngü kurmaya hazırdır.

for root in result.roots:
    print(root.uri, root.name)

Liste Boş Olabilir

Geçerli bir yanıt boş bir liste olabilir. Bu, istemcinin şu anda hiçbir kök sunmadığı anlamına gelir. Bu nedenle bir klasörün var olduğunu varsaymak yerine makul bir geri dönüş davranışı planlayın.

Önce Yeteneği Denetleyin

list_roots çağrısı yalnızca istemci kökleri destekliyorsa anlamlıdır. Özenli bir sunucu, istemciden istemeden önce belirtilen yeteneği denetler ve bu yeteneğe sahip olmayan ana bilgisayarlarda oluşacak hataları önler.

Doğru Zamanda İsteyin

Kökleri onlara ihtiyaç duyduğunuzda, örneğin bir dosya aracının başlangıcında alın. İsteği tembelce yapmak, kullanıcı o zamandan beri farklı bir klasör açtıysa güncel kalmanızı sağlar.

Kökü Yola Dönüştürün

Bir kökün URI'si file:///home/ada gibi bir dizedir. Bunu kullanmak için herhangi bir şeyi açmadan önce file:// URI'sini gerçek bir dosya sistemi yoluna ayrıştırın.

from urllib.parse import urlparse
path = urlparse(root.uri).path

Değişiklikleri Dinleyin

İstemci destekliyorsa kökler değiştiğinde bir bildirim gönderebilir. Bunu yakalamak, güncelliğini yitirmiş bir görünümle çalışmak yerine listeyi yeniden almanızı sağlar.

notifications/roots/list_changed

Başarısızlıkları Nazikçe Yönetin

İstek yine de başarısız olabilir veya zaman aşımına uğrayabilir. Çağrıyı, yanıt alınamadığında aracınızın çökmesi yerine açık bir ileti vermesini sağlayacak şekilde sarmalayın. 🛟

Kısa Denetim

SDK'da istemcinin köklerini almanın doğru yolunu seçin.

İnteraktif derste cevapla

Özet: Kökleri İsteme

Oturum üzerinde list_roots() çağrısının sonucunu bekler, dönen kökler üzerinde döngü kurar, her file:// URI'sini ayrıştırır ve boş veya başarısız yanıtları yönetirsiniz. Kökler değiştiğinde yeniden isteyin. ✅

Başlamak ücretsiz

Yapay zeka eğitmeniyle Python öğren — ücretsiz

Tarayıcında gerçek kod yaz ve çalıştır, 7/24 yapay zeka eğitmeninden anında yardım al; web'de ya da uygulamada kaldığın yerden devam et.

Kurslar: 30
Dersler: 120

Ücretsiz öğrenmeye başla Tüm kursu görüntüle

Sıkça Sorulan Sorular

“İstemcinin Köklerini İsteme” dersi ücretsiz mi?

Evet — “İstemcinin Köklerini İsteme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve MCP Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. MCP Academy kursu toplamda 4 dersten oluşur.

“İstemcinin Köklerini İsteme” dersinde ne öğreneceğim?

İzin verilen çalışma dizinlerinin listesini isteyin. MCP Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

MCP Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te MCP Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 2. dersidir.

“İstemcinin Köklerini İsteme” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu MCP Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her MCP Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← MCP Academy Sayfasına Dön