跳轉到

MCP Builder：用 Skill 引導蓋出生產級 MCP Server

整理自 mcp-builder SKILL.md 與外部介紹（見文末），2026-06-19。MCP Builder 是一個 Claude Code skill,引導 agent 蓋出高品質的 Model Context Protocol（MCP）server——你描述需求,Claude 照框架生成、實作、評估,而不必自己讀完整份 spec。

用途

讓 LLM 透過「設計良好的工具」去接外部服務 / API。重點不是把 API 端點包一包,而是以 agent 為中心設計——對齊真實工作流。

支援語言:Python（FastMCP） 與 Node/TypeScript（MCP SDK）。

四階段工作流

  1. Deep Research & Planning
  2. 研究 agent-centric 設計原則(對齊工作流,而非簡單包 API)
  3. 讀 MCP 協定與框架文件、徹底讀目標 API 文件

  4. 寫完整實作計畫:工具選擇、共用工具、輸入/輸出設計、錯誤處理

  5. Implementation

  6. 建語言對應的專案結構與共用基礎(API helper、錯誤處理、格式化)
  7. 系統性實作工具:輸入驗證、完整文件、妥善錯誤處理

  8. 套語言特定最佳實踐

  9. Review & Refine

  10. code review:DRY、一致性、type safety

  11. 依語言要求 test / build,走品質檢查清單

  12. Create Evaluations

  13. 設計 10 題獨立、唯讀的評估題
  14. 自己手動解一遍驗證答案
  15. 以 XML 的 question-answer 配對格式輸出

核心設計原則

  • 為完整工作流而建,不是孤立端點
  • 為受限的 context window 最佳化
  • 錯誤訊息要 actionable(能據以行動)
  • 依自然的任務切分設計工具
  • 評估驅動開發(eval-driven)

為什麼對你有用

  • 你已把 Codex 接成 MCP server;若要自製 MCP（例如把資料 pipeline、券商 API、lakehouse 查詢包成工具給 agent 用),這個 skill 提供從研究→實作→評估的現成框架,還強迫你寫 eval 驗證,符合「不採信自我驗證」的原則。
  • 「為受限 context 最佳化、錯誤訊息要可行動」這些原則,和 Context Engineering、Agent Skills 漸進揭露 是同一套思路。

參考來源