型ヒントでパラメーターを宣言する
Pythonの型ヒントを使ってツールのスキーマを定義します。
「型ヒントでパラメーターを宣言する」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
パラメーターはスキーマになる
ツール関数の各引数は、モデルがツールを呼び出す際に従う入力スキーマの一部になります。🧩
型ヒントが処理してくれる
FastMCPはPythonの型ヒントを読み取り、JSONスキーマを自動的に作成します。そのため、スキーマを手作業で記述することはほとんどありません。
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr、int、float、bool
基本的な型は簡単に対応付けられます。strはstringに、intとfloatはnumberに、boolはスキーマ上のbooleanになります。
型なしでは不明確
型ヒントを省略すると、モデルにはルールのない曖昧な値としてしか見えません。そのため、誤った入力や無効な入力を招きやすくなります。
def add(a, b):
return a + bデフォルトでは必須
デフォルト値のないパラメーターは必須として扱われるため、モデルはツールを呼び出す際に必ず値を指定する必要があります。
デフォルト値で任意になる
パラメーターにデフォルト値を指定すると、そのパラメーターは任意になります。モデルが省略した場合は、関数が代替値を使用します。
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...リストと辞書
コレクションにも型ヒントを指定できます。list型の引数はJSON配列に、dictはモデルが値を入力できるオブジェクトに対応します。
def tag(items: list[str]) -> int:
return len(items)オプションの値
引数が値またはNoneになり得る場合はOptionalを使い、モデルが意図的に空欄にできることを示します。
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...パラメーター名を明確にする
モデルはスキーマ内の各パラメーター名を参照します。そのため、cよりcity、arg2よりstart_dateのほうが適切です。明確な名前が、よりよい呼び出しにつながります。
型ヒントで検証できる
型ヒントがスキーマを定義するため、MCPはコードを実行する前に誤った型の呼び出しを拒否し、早い段階でミスを検出できます。
シグネチャを小さく保つ
型が適切に定義された少数のパラメーターのほうが、関連性の低い引数を多数並べるよりも、モデルが正しく入力しやすくなります。
クイックチェック
FastMCPでツールのパラメーターを任意にするには、何が必要ですか？
リキャップ
ツールのスキーマは型ヒントから作られます。基本型は直接対応し、デフォルト値は任意を意味し、明確な名前がモデルを導きます。✅
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「型ヒントでパラメーターを宣言する」レッスンは無料ですか？
はい。「型ヒントでパラメーターを宣言する」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「型ヒントでパラメーターを宣言する」で何を学びますか？
Pythonの型ヒントを使ってツールのスキーマを定義します。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「型ヒントでパラメーターを宣言する」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- ツールに適切な名前と説明を付ける
- 型ヒントでパラメーターを宣言する
- 役立つ結果を返す
- 電卓ツールを最初から最後まで作る