Parameter mit Type Hints deklarieren
Verwenden Sie Python-Type-Hints, um das Schema des Tools festzulegen.
Parameter mit Type Hints deklarieren ist eine kostenlose MCP Academy-Lektion auf CoddyKit. Dies ist Lektion 2 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des MCP Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.
Parameter werden zu einem Schema
Jedes Argument Ihrer Tool-Funktion wird zu einem Teil des Eingabe-Schemas, an das sich das Modell beim Aufruf Ihres Tools halten muss. 🧩
Typannotationen übernehmen die Arbeit
FastMCP liest Ihre Python-Typannotationen und erstellt daraus das JSON-Schema, sodass Sie ein Schema nur selten von Hand schreiben müssen.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
Die grundlegenden Typen werden direkt abgebildet: str wird im Schema zu string, int und float zu number und bool zu boolean.
Ohne Typ bleibt es unklar
Wenn Sie die Typannotation weglassen, sieht das Modell nur einen uneingeschränkten Wert ohne Regeln. Das begünstigt falsche oder ungültige Eingaben.
def add(a, b):
return a + bStandardmäßig erforderlich
Ein Parameter ohne Standardwert gilt als erforderlich. Das Modell muss ihn daher beim Aufruf des Tools immer angeben.
Standardwerte machen Parameter optional
Geben Sie einem Parameter einen Standardwert, wird er optional. Das Modell kann ihn weglassen, und Ihre Funktion verwendet den Ersatzwert.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Listen und Dicts
Auch Sammlungen können Sie typisieren. Ein list-Argument wird zu einem JSON-Array, und ein dict wird zu einem Objekt, das das Modell ausfüllen kann.
def tag(items: list[str]) -> int:
return len(items)Optionale Werte
Verwenden Sie Optional, wenn ein Argument entweder einen Wert oder None enthalten kann. Damit signalisieren Sie, dass das Modell es absichtlich leer lassen darf.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Parameter eindeutig benennen
Das Modell sieht jeden Parameternamen im Schema. Daher ist city besser als c und start_date besser als arg2. Klare Namen führen zu besseren Aufrufen.
Typannotationen ermöglichen die Validierung
Da Typannotationen das Schema definieren, kann MCP Aufrufe mit dem falschen Typ ablehnen, bevor Ihr Code ausgeführt wird, und so Fehler früh erkennen.
Die Signatur klein halten
Weniger, gut typisierte Parameter kann das Modell leichter korrekt ausfüllen als eine lange Liste lose zusammenhängender Argumente.
Kurzer Check
Was macht einen Tool-Parameter in FastMCP optional?
Rückblick
Ihre Typannotationen erstellen das Tool-Schema: Grundlegende Typen werden direkt abgebildet, Standardwerte bedeuten optional, und klare Namen leiten das Modell. ✅
Lerne Python mit einem KI-Tutor — kostenlos
Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.
- Kurse
- 30
- Lektionen
- 120
Häufig gestellte Fragen
Ist die Lektion „Parameter mit Type Hints deklarieren“ kostenlos?
Ja — der vollständige Text von „Parameter mit Type Hints deklarieren“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des MCP Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der MCP Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Parameter mit Type Hints deklarieren“?
Verwenden Sie Python-Type-Hints, um das Schema des Tools festzulegen. Du übst MCP Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um MCP Academy zu starten?
Keine Vorkenntnisse erforderlich. MCP Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 2 von 4.
Wie lange dauert die Lektion „Parameter mit Type Hints deklarieren“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser MCP Academy-Lektion Code schreiben und ausführen?
Ja. Jede MCP Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Tools gut benennen und beschreiben
- Parameter mit Type Hints deklarieren
- Nützliche Ergebnisse zurückgeben
- Ein Taschenrechner-Tool von Anfang bis Ende