第三方工具更新 2026.11.14

FastMCP 教學:先驗證工具回傳與錯誤,再接 AI

用 FastMCP 4.2.0 建立合成出貨工具,以記憶體內 Client 檢查工具清單、08:30 回傳與未知單號錯誤;未測 HTTP 部署。

FastMCP 是用 Python 建立與連接 MCP 工具的框架。先把資料契約測對,再接 AI 主機,會比較容易分辨錯誤發生在哪一層。這次用 4.2.0 的記憶體內 Client 驗證工具清單、固定回傳與例外;沒有開 HTTP 連接埠,也沒有讓 LLM 決定何時呼叫工具。

伺服器啟動後,可用 MCP Inspector 的工具呼叫檢查核對介面;檔案工具的範圍設計可參考 Filesystem MCP 的允許目錄。

定義一個答案已知的工具

dispatch_cutoff 接受字串 note。輸入 NOTE-31 回傳 08:30,其他單號引發 ValueError。這刻意保持很小:如果工具本身不穩定,先不用加登入、資料庫或模型,避免把多個問題混在一起。

固定版本並執行本機檢查

在 Python 3.12 的虛擬環境執行下方 shell 區塊,安裝固定版本並執行內嵌的 Python 程式。Client(mcp) 直接連接這個物件,測的是記憶體內路徑,不能把結果當成 stdio、HTTP 或遠端主機已經連線。

以下為 POSIX shell 指令;本次在 Linux 容器測試,未測 Windows shell。

python -m pip install "fastmcp==4.2.0"
python - <<'PY'
import asyncio
from fastmcp import FastMCP, Client
mcp = FastMCP("DispatchFixture")
@mcp.tool
def dispatch_cutoff(note: str) -> str:
    if note != "NOTE-31":
        raise ValueError("Unknown synthetic dispatch")
    return "08:30"
async def check():
    async with Client(mcp) as client:
        print(await client.list_tools())
        print(await client.call_tool("dispatch_cutoff", {"note": "NOTE-31"}))
asyncio.run(check())
PY

本次驗收了哪三件事

list_tools 找到 dispatch_cutoff,輸入結構要求 note 為字串。合法呼叫的文字內容及結構化 result 都是 08:30。未知單號的呼叫引發 ToolError,訊息保留合成錯誤原因。這三個檢查用來確認工具介面;模型是否會正確選工具,需要另一個測試。

部署前還缺哪些證據

HTTP、stdio、OAuth、權限控管與 Gateway 依官方文件 v4.2.0 及上游快照整理,未本地實測。記憶體內成功不代表外部輸入可信,也沒有提供作業系統隔離。接到實際 AI 主機前,應另驗證傳輸、逾時、呼叫權限與資料來源;本頁不把這些寫成已完成。

官方來源與測試範圍

本次為 Codex 在無發布憑證、非 root、斷網容器執行的合成資料測試,不代表站長親測。套件版本為 4.2.0;文件快照為 a8745d61e650。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

也可以在這些平台追蹤: