MCP Academy · Lekcja

Dodawanie narzędzia Hello

Ozdób funkcję Python dekoratorem, aby AI mogła ją wywoływać.

Lekcja 2 z 413 kroki

Dodawanie narzędzia Hello to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.

Nadaj serwerowi umiejętność

Serwer bez narzędzi jest tylko pustą powłoką. Narzędzie to funkcja Pythona, którą AI może wywołać, aby faktycznie coś zrobić dla użytkownika. 🛠️

Magiczny dekorator

FastMCP udostępnia funkcję jako narzędzie za pomocą jednej linii: dekoratora @mcp.tool() umieszczonego bezpośrednio nad definicją funkcji.

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

Napisz zwykłą funkcję

Jej treść to po prostu Python. Bez specjalnego kodu protokołu i bez ręcznego zapisywania JSON-u. Piszesz, co narzędzie ma robić, i zwracasz wartość.

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

Dodaj parametr

Narzędzia stają się bardziej użyteczne, gdy przyjmują dane wejściowe. Dodaj parametr, a model będzie mógł przekazać wartość, gdy zdecyduje się wywołać narzędzie.

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

Adnotacje typów tworzą schemat

Dodaj adnotację typu, taką jak name: str, a FastMCP przekształci ją w schemat danych wejściowych. Model będzie wtedy dokładnie wiedział, jaki rodzaj wartości wysłać.

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

Docstring staje się opisem

Docstring funkcji staje się opisem narzędzia. Model odczytuje go, aby zdecydować, kiedy to narzędzie będzie właściwe.

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

Nazwa pochodzi od funkcji

Domyślnie nazwa narzędzia jest nazwą funkcji. Zatem def greet udostępnia narzędzie, które klient wyświetla jako „greet”.

Zwracaj zwykły tekst

W przypadku pierwszego narzędzia po prostu zwróć ciąg znaków. FastMCP opakuje go w odpowiedni format wyniku MCP, dzięki czemu klient otrzyma przejrzysty tekst.

Opisz je dobrze

Dobre sformułowanie ma znaczenie: jasny opis pomaga modelowi wybrać narzędzie we właściwym momencie. Niejasne docstringi prowadzą do pomijania wywołań.

Rejestracja odbywa się automatycznie

Nie trzeba samodzielnie wywoływać funkcji rejestrującej. Samo ozdobienie funkcji dekoratorem powoduje, że narzędzie zostaje zarejestrowane w instancji mcp i jest gotowe do udostępnienia.

Dodaj ich tyle, ile chcesz

Jeden serwer może zawierać wiele narzędzi. Wystarczy ozdobić dekoratorem każdą funkcję, a wszystkie pojawią się razem, gdy klient zapyta o dostępne możliwości.

Szybkie sprawdzenie

Skąd pochodzi opis narzędzia?

Odpowiedz w interaktywnej lekcji

Podsumowanie

Dodano narzędzie za pomocą @mcp.tool(), nadano jego parametrom typy i użyto docstringu jako opisu. Serwer wreszcie potrafi coś zrobić. Teraz go uruchomimy! ✨

Bezpłatny start

Ucz się Python dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 30
Lekcje: 120

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Dodawanie narzędzia Hello” jest bezpłatna?

Tak — pełny tekst „Dodawanie narzędzia Hello” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Dodawanie narzędzia Hello”?

Ozdób funkcję Python dekoratorem, aby AI mogła ją wywoływać. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć MCP Academy?

Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Dodawanie narzędzia Hello”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?

Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do MCP Academy