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