MCP Academy · Ders

Tür İpuçlarıyla Parametre Bildirme

Araç şemasını biçimlendirmek için Python tür ipuçlarını kullanın.

Tür İpuçlarıyla Parametre Bildirme, CoddyKit'te ücretsiz bir MCP Academy dersidir. Bu, 4 dersinin 2. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, MCP Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. MCP Academy kursu toplamda 4 dersten oluşur.

Bu dersin bazı bölümleri henüz çevrilmemiş olup İngilizce olarak gösterilmektedir.

Parameters Become a Schema

Every argument of your tool function turns into part of an input schema the model must follow when it calls your tool. 🧩

Type Hints Do the Work

FastMCP reads your Python type hints and builds the JSON schema for you, so you rarely write schema by hand.

@mcp.tool()
def add(a: int, b: int) -> int:
    return a + b

str, int, float, bool

The basic types map cleanly: str becomes string, int and float become number, and bool becomes boolean in the schema.

Untyped Means Unclear

Skip the type hint and the model only sees a loose value with no rules, which invites wrong or invalid input.

def add(a, b):
    return a + b

Required by Default

A parameter with no default value is treated as required, so the model must always supply it when calling the tool.

Defaults Make It Optional

Give a parameter a default and it becomes optional. The model may omit it, and your function uses the fallback value.

@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
    ...

Lists and Dicts

You can hint collections too. A list argument maps to a JSON array, and a dict maps to an object the model can fill in.

def tag(items: list[str]) -> int:
    return len(items)

Optional Values

Use Optional when an argument may be a value or None, signaling that the model can leave it empty on purpose.

from typing import Optional
def find(q: str, limit: Optional[int] = None):
    ...

Name Parameters Clearly

The model sees each parameter name in the schema, so city beats c and start_date beats arg2. Clear names guide better calls.

Hints Power Validation

Because hints define the schema, MCP can reject calls with the wrong type before your code runs, catching mistakes early.

Keep the Signature Small

Fewer, well-typed parameters are easier for the model to fill correctly than a long list of loosely related arguments.

Quick Check

What makes a tool parameter optional in FastMCP?

Recap

Your type hints build the tool schema: basic types map directly, defaults mean optional, and clear names guide the model. ✅

Sıkça Sorulan Sorular

“Tür İpuçlarıyla Parametre Bildirme” dersi ücretsiz mi?

Evet — “Tür İpuçlarıyla Parametre Bildirme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve MCP Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. MCP Academy kursu toplamda 4 dersten oluşur.

“Tür İpuçlarıyla Parametre Bildirme” dersinde ne öğreneceğim?

Araç şemasını biçimlendirmek için Python tür ipuçlarını kullanın. MCP Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

MCP Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te MCP Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 2. dersidir.

“Tür İpuçlarıyla Parametre Bildirme” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu MCP Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her MCP Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← MCP Academy Sayfasına Dön