mcp-builder

mcp-builder 技能是一個全面的開發框架，旨在協助工程師與開發者建立穩健的 Model Context Protocol (MCP) 伺服器。透過實作這些伺服器，您可以讓大型語言模型 (LLM) 與外部服務、API 及專有資料來源進行無縫互動。本技能提供結構化的四階段開發方法，涵蓋從架構規劃、協定研究到實作、測試與評估的完整流程。它強調工具命名、內容管理與錯誤處理的最佳實踐，確保所產出的 MCP 工具對於 AI 代理而言具有高可發現性與可操作性。

• 簡化使用標準 MCP 規格整合外部 API 的過程，支援如 stdio 與 streamable HTTP 等傳輸機制及正確的驗證模式。

• 支援 TypeScript (透過 MCP SDK) 與 Python (透過 FastMCP) 開發，提供標準化的專案結構與模組組織。

• 提供設計高效工具結構的指引，使用 Zod 或 Pydantic 進行輸入驗證，並實作結構化輸出架構以提升 LLM 的理解能力。

• 包含提升工具可靠性的技術，例如實作分頁、帶有可操作建議的清晰錯誤訊息，以及使用 idempotentHint 與 destructiveHint 等註解。

• 提供內建的評估工作流程，協助您產生複雜的測試案例，以驗證 MCP 工具在真實場景中的準確性與實用價值。

• 請遵循指定階段：研究 MCP 規格、規劃工具集、實作基礎設施（API 客戶端、格式化、分頁），並建立完整的評估資料集。

• 當不確定時，優先考慮 API 的全面覆蓋範圍而非僅侷限於特定工作流程工具，以賦予代理組合作業的最大彈性。

• 在部署前，務必使用 MCP Inspector (npx @modelcontextprotocol/inspector 或 Python 對應工具) 測試伺服器功能。

• 確保工具描述簡潔且具備資訊量，以協助代理在執行 LLM 期間進行工具探索與內容管理。

• 始終嚴格驗證輸入與輸出；強烈建議回傳結構化資料，以支援進階的客戶端處理。