mcp-patterns
為 Claude Code 構建 MCP 伺服器
متاح أيضًا من: 0xDarkMatter
創建 MCP 伺服器需要了解模型上下文協議模式。本技能提供可直接使用的程式碼範例和最佳實踐,適用於工具、資源、認證和狀態管理,讓您能更快地構建整合。
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "mcp-patterns". Show me how to create a basic MCP server with a tool
النتيجة المتوقعة:
- 基本 MCP 伺服器模式:
- • 使用您的伺服器名稱創建 Server 實例
- • 定義 list_tools() 返回工具 schema
- • 實現 call_tool() 處理工具執行
- • 使用 stdio_server() 進行傳輸
- • 使用 JSON 配置在 Claude Desktop 中設定
استخدام "mcp-patterns". How do I add input validation to my MCP tool?
النتيجة المتوقعة:
- 使用 Pydantic BaseModel 進行驗證:
- • 定義帶有 Field 約束的 SearchInput 類
- • 為字串設置 min_length、max_length
- • 使用 ge 和 le 表示數值邊界
- • 將參數傳遞給 SearchInput(**arguments) 進行自動驗證
استخدام "mcp-patterns". What authentication patterns should I use?
النتيجة المتوقعة:
- 環境變數模式:
- • 從 os.environ.get() 讀取 API_KEY
- • 如果密鑰缺失則引發錯誤
- • 在 Authorization 標頭中傳遞密鑰
- • OAuth 模式:使用帶 TTL 追蹤的 TokenManager 類
التدقيق الأمني
آمنThis is a pure documentation skill containing only code examples and patterns for MCP server development. The static analyzer flagged pattern matches in example code, but all findings are FALSE POSITIVES. The skill contains no executable code, makes no network calls, reads no environment variables, and performs no file system operations at runtime. All code samples are illustrative educational examples demonstrating secure patterns including Pydantic validation, environment variable authentication, and proper error handling.
عوامل الخطر
⚙️ الأوامر الخارجية (43)
🌐 الوصول إلى الشبكة (8)
درجة الجودة
ماذا يمكنك بناءه
構建自定義 MCP 伺服器
創建 MCP 伺服器,將您的 API 和工具公開給 Claude Code,以實現增強的 AI 整合。
設計伺服器模式
為生產 MCP 伺服器實現適當的認證、快取和狀態管理模式。
參考程式碼範例
使用模式參考來記錄帶有可運行程式碼範例的 MCP 伺服器實現。
جرّب هذه الموجهات
展示如何創建一個公開搜索數據工具的基本 MCP 伺服器。
如何為我的 MCP 工具添加 Pydantic 驗證以確保輸入安全且正確?
在我的 MCP 伺服器中應該使用什麼模式來快取 API 回應以減少延遲?
展示如何在我的 MCP 伺服器中實現帶有過期處理的 OAuth 令牌刷新。
أفضل الممارسات
- 使用 Pydantic 模型驗證工具輸入並防止注入攻擊
- 使用 isError 標誌返回正確的錯誤回應以實現優雅的失敗處理
- 將敏感憑證存儲在環境變數中,切勿寫入程式碼
- 實施基於 TTL 的快取以減少 API 呼叫並改善回應時間
تجنب
- 將 API 密鑰或機密直接硬編碼在源碼中
- 跳過輸入驗證並信任用戶提供的參數
- 返回未經清理的原始異常,這會洩露實現細節
- 在非同步處理程序中進行同步 HTTP 呼叫,這會阻塞事件循環