FastMCP 4：把函式變成 AI 工具，
一發請求不用握手

上一課你手寫工具說明書、手組兩回合。MCP 把這件事標準化：你蓋一台工具伺服器， Claude Desktop、Claude Code、Cursor 都能直接接上來用你的函式；FastMCP 讓這台伺服器只剩一個裝飾器。 而 4.0 最大的改版是協定變無狀態——同樣「呼叫一次 add」，舊協定要握手、發 session id、綁死同一台伺服器； 新協定每個請求自帶一切。按下去比較：

這堂課的 notebook 不連任何外部服務——它會在 molab 裡真的起一台 HTTP 伺服器並側錄每個請求， 上面這張圖的每一列都是實測結果。本課用 fastmcp==4.0.0b1。

說明書自動生成、參數自動把關

你沒有寫任何 schema。FastMCP 從型別提示、預設值與 docstring 生成說明書： limit 有 default: 3、keyword 在 required。 用 Client(mcp) 直接連同一個 process 裡的伺服器（不開網路）就能 list_tools()、call_tool()；故意把 a 給成 "two"， pydantic 在進你的函式之前就擋下，回一個 ToolError 說明哪個欄位錯。

工具之外還有兩種東西：resource（給 AI 讀的資料，URI 定址如 menu://today， URI 放 {name} 就是 template）與 prompt（帶參數的話術範本）。 tool 是模型主動呼叫、resource 是應用決定要不要餵、prompt 是使用者挑選。

同一台伺服器、兩種協定，側錄給你看

notebook 用 mcp.http_app()（標準 ASGI app）在背景起一台真的 HTTP 伺服器，前面塞一個只側錄不干擾的中介層。 Client(網址) 自動協商最新協定，mode="legacy" 強制舊的。兩邊各呼叫一次 add：

最有感的證明：不用 SDK、不握手，一發 httpx.post 就能呼叫工具——

傳輸無狀態，應用照樣記得你：SessionId

購物車、多步驟流程怎麼辦？4.0 的答案是把狀態綁在一把鑰匙上而不是連線上： 裝上 SessionProvider()，伺服器自動多出 create_session()（發一把猜不到的 uuid） 與 end_session()；你的工具宣告 session_id: SessionId，用 get_session(session_id) 拿到可 get／set 的小儲存格。

實測：拿鑰匙加兩樣東西 → 換一條全新連線帶同一把鑰匙 → 購物車還在；亂猜一把 → Invalid or unknown session。 FastMCP 還會在 session_id 的 schema 裡自動寫一段給 AI 看的說明（先建 session、之後每次帶著）。 另一個選項 session: UserSession 自動注入、不進 schema，但要有認證身分——它把狀態綁在登入的使用者上。

接給真的 AI 客戶端

接上之後對 AI 說「幫我找有茶的飲料」，它會自己呼叫 search_menu。 4.0 還拿掉了 ctx.sample()、ctx.list_roots() 這類需要活連線的反向呼叫、 新增多回合互動工具與背景任務——細節在 notebook 末節，知道有就好。

換你動手

卡住了？每一題在 notebook 末節都有折疊解答——先自己做，再打開對照。

情境測驗

離開前試試看：下面的情境都真的會遇到。每題選一個你認為的最佳做法，選了馬上看得到解釋。