Helloツールを追加する
Python関数にデコレーターを付け、AIから呼び出せるようにします。
「Helloツールを追加する」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン2/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
サーバーに機能を持たせる
ツールのないサーバーは、ただの入れ物です。ツールとは、AIが呼び出してユーザーのために実際の処理を行えるPython関数です。🛠️
魔法のデコレーター
FastMCPでは、関数定義のすぐ上に@mcp.tool()デコレーターを1行置くだけで、その関数をツールとして公開できます。
@mcp.tool()
def hello():
...通常の関数を書く
本体は普通のPythonです。特別なプロトコルコードも、JSONを手作業で書く必要もありません。ツールが行う処理を書いて、値を返します。
@mcp.tool()
def hello():
return "Hello from MCP!"パラメーターを追加する
入力があると、ツールはさらに便利になります。パラメーターを追加すると、モデルはツールを呼び出すときに値を渡せるようになります。
@mcp.tool()
def greet(name):
return "Hello, " + name型ヒントからスキーマが作られる
name: strのような型ヒントを追加すると、FastMCPが入力スキーマに変換します。これによりモデルは、どのような値を送ればよいか正確に分かります。
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + namedocstringが説明になる
関数のdocstringが、そのツールの説明になります。モデルはそれを読んで、そのツールを使うべき場面を判断します。
@mcp.tool()
def greet(name: str) -> str:
"""Greet a person by name."""
return "Hello, " + name関数名がツール名になる
デフォルトでは、ツールの名前は関数名になります。そのため、def greetと書くと、クライアントには「greet」という名前のツールとして表示されます。
プレーンテキストを返す
最初のツールでは、文字列をreturnするだけで十分です。FastMCPが適切なMCPの結果形式に包むため、クライアントはきれいなテキストを受け取れます。
分かりやすく説明する
適切な表現が重要です。明確な説明があると、モデルは適切なタイミングでツールを選べます。曖昧なdocstringでは、呼び出してもらえないことがあります。
自動的に登録される
自分で登録関数を呼び出す必要はありません。デコレーターを付けるだけで、ツールがmcpインスタンスに登録され、利用可能であることが通知されます。
好きなだけ追加できる
1つのサーバーに複数のツールを持たせられます。各関数にデコレーターを付けるだけで、クライアントが利用可能な機能を尋ねたときに、すべてまとめて表示されます。
簡単な確認
ツールの説明はどこから取得されますか？
まとめ
@mcp.tool()でツールを追加し、型付きパラメーターを指定して、docstringに説明を書きました。これでサーバーが実際に処理を行えるようになりました。次は実行してみましょう！✨
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「Helloツールを追加する」レッスンは無料ですか？
はい。「Helloツールを追加する」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「Helloツールを追加する」で何を学びますか？
Python関数にデコレーターを付け、AIから呼び出せるようにします。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン2/4です。
「Helloツールを追加する」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- FastMCPインスタンスを作成する
- Helloツールを追加する
- stdioでサーバーを実行する
- 読み込みとツール一覧を確認する