mcp-builder
為 Claude Code 構建 MCP 伺服器
也可從以下取得: AutumnsGrove,92Bilal26,YYH211,anthropics,92Bilal26,davila7,ZhanlinCui,ArtemisAI,Azeem-2,Doyajin174,DYAI2025,Cam10001110101,ComposioHQ,mcp-use
此技能提供全面的指導，幫助您建構 Model Context Protocol 伺服器，使 Claude Code 和 Codex 能夠透過精心設計的工具與外部 API 進行互動。內容涵蓋 TypeScript 和 Python 實作、最佳實踐和評估策略。
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「mcp-builder」。 如何設定 TypeScript 中的基本 MCP 伺服器專案？
預期結果:
要在 TypeScript 中設定基本的 MCP 伺服器專案：
1. 初始化新的 Node.js 專案：npm init -y
2. 安裝 MCP TypeScript SDK：npm install @modelcontextprotocol/server-sdk
3. 使用 Zod 建立包含工具定義的伺服器檔案以進行輸入驗證
4. 向伺服器註冊工具並定義傳輸方式（stdio 或 Streamable HTTP）
5. 為您選擇的傳輸方式匯出伺服器
此技能為每個步驟提供完整範例和代碼片段。
正在使用「mcp-builder」。 MCP 伺服器中工具命名的最佳實踐是什麼？
預期結果:
MCP 工具命名的最佳實踐：
- 使用一致的前綴（例如 github_create_issue、github_list_repos）
- 使用描述工具功能的動作導向名稱
- 使名稱能清楚描述正在整合的服務
- 避免在名稱中使用版本號
- 使用清晰、明確的名稱，幫助代理程式快速找到正確的工具
正在使用「mcp-builder」。 我應該如何建構 MCP 伺服器中的錯誤訊息？
預期結果:
錯誤訊息應該可操作並引導代理程式找到解決方案：
- 包含修復錯誤的具體建議
- 提供代理程式可以採取的下一步
- 使用標準的 JSON-RPC 錯誤碼
- 使錯誤訊息足夠描述性，讓 LLM 能夠理解出了什麼問題以及如何恢復
安全審計
安全This skill is a documentation and guide resource for building MCP servers. The static scanner detected patterns (network calls, environment variable access, shell commands) in reference documentation files containing code examples. These are all false positives - the skill contains no executable code, only markdown documentation with example code snippets demonstrating standard API integration patterns.
風險因素
⚡ 包含腳本
🌐 網路存取
📁 檔案系統存取
🔑 環境變數
⚙️ 外部命令
品質評分
你能建構什麼
為自訂 API 建構新的 MCP 伺服器
開發人員想要建立一個 MCP 伺服器，將其公司的內部 API 與 Claude Code 整合。他們遵循逐步指南來規劃、實作和測試其 MCP 伺服器。
學習 MCP 協議最佳實踐
技術作家或產品經理想要了解 MCP 伺服器的工作原理，以及什麼使其能有效地與 LLM 整合。
評估現有 MCP 伺服器品質
AI 工程師想要評估其 MCP 伺服器實作，以確保 LLM 能夠有效地使用所提供的工具。
試試這些提示
幫助我使用 TypeScript SDK 建立一個基本的 MCP 伺服器。我想暴露一個簡單的 API（如待辦事項清單），並提供建立、讀取、更新和刪除工具。請顯示專案結構和核心實作。
如何為我的 MCP 伺服器新增 API 金鑰認證？我需要從環境變數讀取 API 金鑰，並將其包含在對外部服務的請求中。
審查我的 MCP 伺服器工具描述並提出改進建議。我想確保 Claude Code 能夠理解每個工具的作用並有效地使用它們。以下是我目前的工具定義：[新增工具定義]
幫助我為我的 MCP 伺服器建立一個評估框架。我想測試 Claude Code 是否能夠有效地使用我的工具來回答關於我的 API 的現實問題。
最佳實務
- 優先考慮全面的 API 覆蓋範圍，而不是高階工作流程工具，以給予代理程式靈活性
- 使用明確的工具定義，包含標題、描述、inputSchema 和註釋
- 使用 Zod（TypeScript）或 Pydantic（Python）設計輸入驗證，以獲得執行時期類型安全
- 使用評估框架測試您的 MCP 伺服器，以確保 LLM 能夠有效地使用您的工具
避免
- 避免使用模糊的工具名稱，不能清楚描述執行的動作
- 不要跳過輸入驗證 - 始終使用適當的架構驗證使用者輸入
- 避免從工具返回過於冗長或未過濾的資料 - 設計專注的回應
- 不要使用通用的錯誤訊息 - 提供可操作的恢復指導