Deklarowanie parametrów za pomocą adnotacji typów
Użyj adnotacji Python, aby kształtować schemat narzędzia.
Deklarowanie parametrów za pomocą adnotacji typów 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.
Parametry stają się schematem
Każdy argument funkcji narzędzia staje się częścią wejściowego schematu, którego model musi przestrzegać podczas wywoływania narzędzia. 🧩
Adnotacje typów wykonują pracę
FastMCP odczytuje pythonowe adnotacje typów i tworzy za Ciebie schemat JSON, więc rzadko trzeba pisać schemat ręcznie.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
Podstawowe typy są mapowane bezpośrednio: str staje się string, int i float stają się number, a bool staje się boolean w schemacie.
Brak typu oznacza niejasność
Jeśli pominiesz adnotację typu, model zobaczy jedynie luźną wartość bez reguł, co sprzyja błędnym lub nieprawidłowym danym wejściowym.
def add(a, b):
return a + bDomyślnie wymagane
Parametr bez wartości domyślnej jest traktowany jako wymagany, więc model zawsze musi go podać podczas wywoływania narzędzia.
Wartości domyślne oznaczają opcjonalność
Przypisz parametrowi wartość domyślną, a stanie się opcjonalny. Model może go pominąć, a funkcja użyje wartości zastępczej.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Listy i słowniki
Możesz określać również kolekcje. Argument typu list jest mapowany na tablicę JSON, a dict na obiekt, który model może wypełnić.
def tag(items: list[str]) -> int:
return len(items)Wartości opcjonalne
Użyj Optional, gdy argument może zawierać wartość albo None, sygnalizując, że model może celowo pozostawić go pustym.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Nadawaj parametrom jasne nazwy
Model widzi w schemacie nazwę każdego parametru, dlatego city jest lepsze niż c, a start_date lepsze niż arg2. Jasne nazwy pomagają w prawidłowym wywoływaniu narzędzia.
Adnotacje umożliwiają walidację
Ponieważ adnotacje definiują schemat, MCP może odrzucić wywołania z niewłaściwym typem, zanim uruchomi się Twój kod, i wcześnie wykryć błędy.
Ogranicz liczbę parametrów
Mniejsza liczba dobrze typowanych parametrów jest łatwiejsza do prawidłowego uzupełnienia przez model niż długa lista luźno powiązanych argumentów.
Szybkie sprawdzenie
Co sprawia, że parametr narzędzia jest opcjonalny w FastMCP?
Podsumowanie
Twoje adnotacje typów budują schemat narzędzia: typy podstawowe są mapowane bezpośrednio, wartości domyślne oznaczają opcjonalność, a jasne nazwy pomagają modelowi. ✅
Często zadawane pytania
Czy lekcja „Deklarowanie parametrów za pomocą adnotacji typów” jest bezpłatna?
Tak — pełny tekst „Deklarowanie parametrów za pomocą adnotacji typów” 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 „Deklarowanie parametrów za pomocą adnotacji typów”?
Użyj adnotacji Python, aby kształtować schemat narzędzia. Ć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 „Deklarowanie parametrów za pomocą adnotacji typów”?
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
- Dobre nazywanie i opisywanie narzędzi
- Deklarowanie parametrów za pomocą adnotacji typów
- Zwracanie użytecznych wyników
- Narzędzie kalkulatora od początku do końca