MCP Academy · Oppitunti

Hello-työkalun lisääminen

Koristelkaa Python-funktio niin, että AI voi kutsua sitä.

Oppitunti 2/413 vaihetta

Hello-työkalun lisää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.

Anna palvelimellesi taito

Palvelin ilman työkaluja on vain kuori. Työkalu on Python-funktio, jota tekoäly voi kutsua tehdäkseen käyttäjälle jotakin. 🛠️

Taikakoristelija

FastMCP julkaisee funktion työkaluna yhdellä rivillä: funktion määrittelyn yläpuolelle sijoitettavalla @mcp.tool()-koristelijalla.

@mcp.tool()
def hello():
    ...

Kirjoita tavallinen funktio

Rungossa on vain Pythonia. Et tarvitse erityistä protokollakoodia tai käsin kirjoitettua JSONia. Kirjoitat, mitä työkalun tulee tehdä, ja palautat arvon.

@mcp.tool()
def hello():
    return "Hello from MCP!"

Lisää parametri

Syöte tekee työkaluista hyödyllisempiä. Lisää parametri, niin malli voi välittää arvon päättäessään kutsua työkalua.

@mcp.tool()
def greet(name):
    return "Hello, " + name

Tyyppivihjeet muodostavat skeeman

Lisää tyyppivihje, kuten name: str, niin FastMCP muuntaa sen syöteskeemaksi. Malli tietää silloin tarkalleen, millaisen arvon sen tulee lähettää.

@mcp.tool()
def greet(name: str) -> str:
    return "Hello, " + name

Docstringistä tulee kuvaus

Funktion docstringistä tulee työkalun kuvaus. Malli lukee sen päättääkseen, milloin juuri tätä työkalua kannattaa käyttää.

@mcp.tool()
def greet(name: str) -> str:
    """Greet a person by name."""
    return "Hello, " + name

Nimi tulee funktiosta

Työkalun nimi on oletusarvoisesti funktion nimi. Siksi def greet julkaisee työkalun, jonka asiakas luettelee nimellä "greet".

Palauta pelkkää tekstiä

Palauta ensimmäisessä työkalussa vain merkkijono. FastMCP käärii sen oikeanlaiseen MCP-tulosrakenteeseen, joten asiakas saa siistiä tekstiä.

Kuvaile se hyvin

Hyvällä sanamuodolla on väliä: selkeä kuvaus auttaa mallia valitsemaan työkalusi oikealla hetkellä. Epämääräiset docstringit johtavat siihen, että kutsuja jää tekemättä.

Rekisteröinti tapahtuu automaattisesti

Sinun ei tarvitse kutsua rekisteröintifunktiota itse. Kun koristelet funktion, työkalu rekisteröidään mcp-instanssiin ja se on valmis ilmoitettavaksi.

Lisää niin monta kuin haluat

Yhdessä palvelimessa voi olla monta työkalua. Koristele vain jokainen funktio, niin ne kaikki näkyvät yhdessä, kun asiakas kysyy käytettävissä olevista työkaluista.

Pikakertaus

Mistä työkalun kuvaus tulee?

Vastaa interaktiivisessa oppitunnissa

Kertaus

Lisäsit työkalun @mcp.tool()-koristelijalla, annoit sille tyypitetyt parametrit ja annoit docstringin kuvata sen. Palvelimesi osaa vihdoin tehdä jotakin. Käynnistetään se nyt! ✨

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 ”Hello-työkalun lisääminen” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa MCP Academy-oppimispolun 3 oppituntia, myös oppitunnin “Hello-työkalun lisää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 ”Hello-työkalun lisääminen”?

Koristelkaa Python-funktio niin, että AI voi kutsua sitä. 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 ”Hello-työkalun lisää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

FastMCP-instanssin luominen
Hello-työkalun lisääminen
Palvelimen ajaminen stdio-siirtotavalla
Latautumisen ja työkalujen näkymisen varmistaminen

← Takaisin: MCP Academy