Model Context Protocol 實務
為代理程式(agent)提供工具與資料,寫給熟悉 API 的工程師:說明 MCP 在 HTTP API 之上增加了什麼、何時不該選用 MCP,以及如何依據規格修訂版 2026-07-28,使用 Python SDK(mcp 2.x)設計、建置、保護、測試與營運 MCP 伺服器與用戶端,並提供從 2025 年各修訂版遷移的路徑。
適合對象 本書寫給建置或呼叫 HTTP API 的工程師,這些讀者現在需要為代理程式(agent)提供工具與資料,或是將代理程式連接到他人的系統。不需要具備機器學習的背景。
在 Kindle 或任何電子閱讀器上閱讀
此 EPUB 亦可於 Apple Books、Kobo 及多數電子閱讀器上閱讀。
傳送至 Kindle
將本版次的 EPUB 寄送至 繁體中文.
-
核准我們的地址
Amazon 只會從您已核准的地址將內容寄送到 Kindle,且每個寄送服務都須個別核准。請將我們的地址加入您的「已核准的個人文件電子郵件清單」。
books@rollingedition.com開啟 Amazon 的個人文件設定. 在 Amazon 上,路徑為「管理您的內容和裝置」、「偏好設定」、「個人文件設定」。
已傳送。幾分鐘內將會出現在你的 Kindle 書庫中。
如果未能送達,幾乎都是第 1 步的核准設定出了問題:請確認 books@rollingedition.com 已列入你的「已核准的個人文件電子郵件清單」。
您已儲存之書籍的每個新版次,也會送達您的 Kindle。
這不是 Kindle 地址。地址應以 @kindle.com 結尾,可在 Amazon 的個人文件設定中找到。
你今天已寄送 {count} 本書,這是單一帳戶一天的寄送上限。請明天再試。
今日的書籍寄送已達上限。請明日再試。
本書未能寄出。請於數分鐘後再試。
本版次檔案過大,無法以電子郵件寄送。
傳送至 Kindle 功能隨 Labs 提供。
這不是 Kindle 地址。地址應以 @kindle.com 結尾,可在 Amazon 的個人文件設定中找到。
本書未能寄出。請於數分鐘後再試。
或下載 EPUB 檔,並將其拖曳至 Amazon 的 Send to Kindle 頁面。
Kindle is a trademark of Amazon.com, Inc.
目錄
12 章,閱讀時間約 18 小時 37 分鐘,附有70 個範例。
-
1MCP end to end
By the end of this chapter you can put an existing HTTP API behind a Model Context Protocol server over stdio, call its tool from a client, read every message the two exchange, and let a model choose the tool through a small host.
-
2MCP 為 API 增添了什麼
讀完本章後,你能說明主機(host)、用戶端(client)與伺服器(server)各自負責什麼,能把商店的每項功能放進正確的 Model Context Protocol 原語(primitive),能讀懂每個請求所攜帶的版本與能力資訊,也能判斷商店何時應該保留單純的 HTTP API。
-
3設計模型能夠使用的工具
讀完本章後,你將能把商店的 API 轉換成 Model Context Protocol 工具,使其名稱、描述、輸入結構描述、結果與錯誤都能讓模型據以行動,並且能量測更動某個描述後,模型所選擇的工具會有何改變。
-
4Serve data as resources and prompts
By the end of this chapter you can publish the shop's policies and records as Model Context Protocol resources, address many records with one resource template, complete an argument while a user types it, tell a client when a resource changes, and package a refund review as a prompt the user can pick.
-
5Ask the user in the middle of a call
By the end of this chapter you can make the shop's refund tool stop in the middle of a call, ask the person at the host to confirm a refund, and carry on with the answer, using Model Context Protocol elicitation inside a Multi Round-Trip Request on a server that keeps no call open while it waits.
-
6透過 Streamable HTTP 提供服務
讀完本章,你將能透過 Streamable HTTP 提供商店的 Model Context Protocol 伺服器、讀懂每個請求與回應所攜帶的內容、將長時間呼叫的進度以串流方式回傳並取消該呼叫、以多個副本在同一個位址後執行伺服器而不使用黏性工作階段(sticky session),並拒絕瀏覽器被誘騙送出的請求。
-
7Run long work as tasks
By the end of this chapter you can negotiate a Model Context Protocol extension, run a slow restock report as a task that the client polls, let tasks expire and cancel them, and say what MCP Apps add to a tool.
-
8以 OAuth 授權用戶端
讀完本章,你就能用 OAuth 保護商店的 Model Context Protocol 伺服器。
-
9保護工具以防濫用
讀完本章後,你將能夠為 Model Context Protocol 伺服器及其主機劃定信任邊界、拒絕權杖直通(token passthrough)、避免伺服器淪為困惑的代理人(confused deputy)、固定工具定義以便發現被更動的定義、將工單文字視為資料,以及在任何具有副作用的工具呼叫之前詢問使用者。
-
10建構能處理工單的主機端
讀完本章後,你可以將一個主機端連接到多個 Model Context Protocol 伺服器,為它們的工具取不會衝突的名稱,執行一段簡短的迴圈讓模型呼叫工具並讀取結果,代替使用者回應伺服器的輸入請求,將資源放入模型的上下文,並讓一整個工單佇列通過上述所有環節。
-
11測試伺服器並觀察其運作
讀完本章後,你可以在記憶體內與透過 HTTP 測試 Model Context Protocol 伺服器的工具、在發布前找出會破壞用戶端的 schema 變更、將錄製的主機端執行重播為迴歸測試、以 OpenTelemetry 追蹤工具呼叫、衡量模型選對工具的頻率,以及在不破壞既有用戶端的情況下淘汰一項工具。
-
12遷移 2025 年代的伺服器
讀完本章後,你可以將依 2025 年各版修訂與 Python SDK 1.x 系列撰寫的 Model Context Protocol 伺服器,遷移到修訂版本 2026-07-28 的規格與
mcp2.3.0。