技能包

mcp-builder:規劃並實作高品質 MCP 伺服器

適合在要用 TypeScript MCP SDK 或 Python FastMCP 接入外部服務時使用,前提是先完成深入調研與規劃,再用 npm run build 和官方 Inspector 檢查。

官方來源 · mcp-builder

安裝

npx @modelcontextprotocol/inspector

適合誰

當你要建立高品質 MCP(Model Context Protocol)伺服器,讓模型透過設計良好的工具呼叫外部 API 或服務時,使用 mcp-builder。語言可以是 Python(FastMCP)或 Node/TypeScript(MCP SDK)。它是一份建構指南,不是替你託管未點名的伺服器。

更合適的前提是:你願意先做深入調研和規劃,而不是一上來就寫介面。資料把 TypeScript 寫成 SDK 支援更好、在多種執行環境(例如 MCPB)相容性更好的選擇。資料沒有給出代理產品名單或倉庫安裝路徑。官方說明頁是

https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md

3 分鐘完成第一次嘗試

這條說明沒有給出 skill 安裝命令,第一次不要編造路徑。建議路徑從第一階段開始:Deep Research and Planning。高品質 MCP 伺服器有四個主要階段,摘錄只完整寫出第一階段標題,因此第一次只做規劃,不寫服務行程。

前置:你已經有一個要接入的外部 API 或服務。低風險動作:列出該服務有哪些唯讀查詢、哪些會改資料,並決定遠端用 Streamable HTTP。摘要還提到本機可用 stdio,但摘錄只寫了遠端的 Streamable HTTP,因此第一次不要假設 stdio 參數已經寫全。

成功訊號:一頁紙能說清「給模型哪些工具、輸入用什麼約束」。不要先 npm init 一個未規劃的專案。規劃確認後再進入實作;TypeScript 側可用 Zod 做輸入 schema,欄位要有約束、清楚描述,並在欄位描述裡加例子。寫檔前先確認目錄。

使用案例

案例一:按 TypeScript 建議堆疊規劃一個遠端伺服器。選定 MCP SDK,傳輸用 Streamable HTTP,輸入用 Zod,描述裡帶約束和例子。摘要還提到 outputSchema/structuredContent,以及 readOnlyHint、destructiveHint 等註解,但摘錄沒有寫出這些欄位的完整示例,因此本案例完成標準是規劃裡區分唯讀與會改資料的工具,而不是已經填好全部註解。不要同時起一套 Python 作為「主路徑」;Python FastMCP 與 Pydantic 是並列選項,不是必須雙寫。

案例二:實作之後做編譯與檢查。TypeScript 路徑是先 npm run build 確認能編譯,再用 MCP Inspector:npx @modelcontextprotocol/inspector。Inspector 會開檢查介面,屬於有副作用的步驟,先確認要測的是你剛建構的本機或遠端伺服器,再執行。完成標準是 build 通過,並且 Inspector 能連上你指定的服務。摘錄沒有寫出 Inspector 的全部旗標,因此不要編造連線參數。

使用界線

四個主要階段從深入調研與規劃開始;後續摘要概括為實施再檢查測試,但其餘階段標題未在摘錄展開。遠端傳輸寫明 Streamable HTTP。輸入 schema 用 Zod 或 Pydantic。TypeScript 檢查命令是 npm run build 與官方 Inspector。

不要編造倉庫內安裝路徑。資料沒有給出用戶端名單,也沒有寫如何跳過規劃直接發布。超出這些已寫明的階段、語言選項和檢查命令,這份說明涵蓋不到。