MCP Academy · Oppitunti

Asiakkaan juurihakemistojen pyytäminen

Pyytäkää luettelo sallituista työskentelyhakemistoista.

Oppitunti 2/413 vaihetta

Asiakkaan juurihakemistojen pyytäminen on ilmainen MCP Academy-oppitunti CoddyKitissä. Tämä on oppitunti 2/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu MCP Academy-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. MCP Academy-kurssilla on yhteensä 4 oppituntia.

Pyydetään niitä seuraavaksi

Juuriin tutustuminen on vasta ensimmäinen vaihe. Toisessa vaiheessa pyydetään asiakkaalta sen nykyinen luettelo, jotta palvelin voi päättää, mistä se saa lukea tai mihin kirjoittaa. 📨

Palvelin aloittaa

Tässä suunta vaihtuu: palvelin lähettää pyynnön ja asiakas vastaa. Käytettävä metodi on roots/list, jolla pyydetään kaikki asiakkaan tällä hetkellä tarjoamat juuret.

{ "method": "roots/list" }

Juurien käyttö kontekstin kautta

Python SDK:ssa raakaa JSON-dataa ei tarvitse muodostaa itse. Käytätte työkalulle annettua pyynnön kontekstioliota, joka käärii aktiivisen yhteyden asiakkaaseen.

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

Yksi helppo kutsu

Kutsutte tästä kontekstista metodia list_roots() ja odotatte sen valmistumista. SDK lähettää roots/list-pyynnön puolestanne ja palauttaa asiakkaan vastauksen tyypitettynä tuloksena.

result = await ctx.session.list_roots()

Mitä palautuu

Vastauksessa on roots-luettelo. Jokaisella alkiolla on uri ja valinnainen nimi, täsmälleen aiemmin nähty pieni rakenne, jonka läpi voitte iteroida.

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

Luettelo voi olla tyhjä

Kelvollinen vastaus voi olla tyhjä luettelo. Se tarkoittaa, ettei asiakas tarjoa juuri nyt juuria, joten suunnitelkaa järkevä varatoiminto sen sijaan, että olettaisitte jonkin kansion olevan olemassa.

Tarkistakaa ominaisuus ensin

list_roots-kutsussa on järkeä vain, jos asiakas tukee juuria. Hyväkäytöksinen palvelin tarkistaa ilmoitetun ominaisuuden ennen pyyntöä ja välttää näin virheet isännissä, jotka eivät sitä tue.

Pyytäkää oikeaan aikaan

Hakekaa juuret tarvittaessa, esimerkiksi tiedostotyökalun alussa. Tarvittaessa tehtävä haku pitää tiedot ajan tasalla, jos käyttäjä on sillä välin avannut toisen kansion.

Muunna juuri poluksi

Juuren uri on merkkijono, kuten file:///home/ada. Jotta voitte käyttää sitä, jäsentäkää file://-URI oikeaksi tiedostojärjestelmän poluksi ennen minkään sen sisällä olevan avaamista.

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

Kuunnelkaa muutoksia

Jos asiakas tukee toimintoa, se voi lähettää ilmoituksen juurten muuttuessa. Kun käsittelette ilmoituksen, voitte hakea luettelon uudelleen vanhentuneen näkymän käyttämisen sijaan.

notifications/roots/list_changed

Käsitelkää virheet hallitusti

Pyyntö voi silti epäonnistua tai aikakatkaista. Käärikää kutsu niin, että puuttuva vastaus antaa työkalulle selkeän viestin kaatumisen sijaan. 🛟

Pikatarkistus

Valitkaa oikea tapa hakea asiakkaan juuret SDK:ssa.

Vastaa interaktiivisessa oppitunnissa

Kertaus: juurten pyytäminen

Odotatte istunnossa list_roots()-kutsun valmistumista, käytte palautetut juuret läpi, jäsennätte kunkin file://-URI:n ja käsittelette tyhjät tai epäonnistuneet vastaukset. Pyytäkää tiedot uudelleen, kun juuret muuttuvat. ✅

Aloita maksutta

Opi Python tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit: 30
Oppitunnit: 120

Aloita opiskelu maksutta Näytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”Asiakkaan juurihakemistojen pyytäminen” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa MCP Academy-oppimispolun 3 oppituntia, myös oppitunnin “Asiakkaan juurihakemistojen pyytäminen”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. MCP Academy-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Asiakkaan juurihakemistojen pyytäminen”?

Pyytäkää luettelo sallituista työskentelyhakemistoista. Harjoittelet MCP Academy-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni MCP Academy-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin MCP Academy-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 2/4.

Kuinka kauan ”Asiakkaan juurihakemistojen pyytäminen”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä MCP Academy-oppitunnilla?

Kyllä. Jokainen MCP Academy-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

← Takaisin: MCP Academy