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。