المهارات mcp-patterns
🔗

mcp-patterns

آمن ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة🔑 متغيرات البيئة

為 Claude Code 構建 MCP 伺服器

متاح أيضًا من: 0xDarkMatter

創建 MCP 伺服器需要了解模型上下文協議模式。本技能提供可直接使用的程式碼範例和最佳實踐,適用於工具、資源、認證和狀態管理,讓您能更快地構建整合。

يدعم: Claude Codex Code(CC)
📊 70 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "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 類

التدقيق الأمني

آمن
v3 • 1/16/2026

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.

7
الملفات التي تم فحصها
644
الأسطر التي تم تحليلها
3
النتائج
3
إجمالي عمليات التدقيق

عوامل الخطر

⚙️ الأوامر الخارجية (43)
🌐 الوصول إلى الشبكة (8)
🔑 متغيرات البيئة (8)
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

45
الهندسة المعمارية
100
قابلية الصيانة
85
المحتوى
22
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

構建自定義 MCP 伺服器

創建 MCP 伺服器,將您的 API 和工具公開給 Claude Code,以實現增強的 AI 整合。

設計伺服器模式

為生產 MCP 伺服器實現適當的認證、快取和狀態管理模式。

參考程式碼範例

使用模式參考來記錄帶有可運行程式碼範例的 MCP 伺服器實現。

جرّب هذه الموجهات

基本 MCP 伺服器
展示如何創建一個公開搜索數據工具的基本 MCP 伺服器。
添加驗證
如何為我的 MCP 工具添加 Pydantic 驗證以確保輸入安全且正確?
實現快取
在我的 MCP 伺服器中應該使用什麼模式來快取 API 回應以減少延遲?
處理認證
展示如何在我的 MCP 伺服器中實現帶有過期處理的 OAuth 令牌刷新。

أفضل الممارسات

  • 使用 Pydantic 模型驗證工具輸入並防止注入攻擊
  • 使用 isError 標誌返回正確的錯誤回應以實現優雅的失敗處理
  • 將敏感憑證存儲在環境變數中,切勿寫入程式碼
  • 實施基於 TTL 的快取以減少 API 呼叫並改善回應時間

تجنب

  • 將 API 密鑰或機密直接硬編碼在源碼中
  • 跳過輸入驗證並信任用戶提供的參數
  • 返回未經清理的原始異常,這會洩露實現細節
  • 在非同步處理程序中進行同步 HTTP 呼叫,這會阻塞事件循環

الأسئلة المتكررة

我需要什麼 Python 版本?
MCP 伺服器開發需要 Python 3.10+ 或 Node.js 18+ 以支援非同步和類型提示。
我可以公開多少個工具?
MCP 不限制工具數量,但過多的工具可能會影響 Claude 的回應品質。將相關工具分組。
我可以和 Claude Code 一起使用嗎?
可以。在 Claude Desktop 或您的 MCP 用戶端中設定您的 MCP 伺服器,以將工具公開給 Claude Code。
我的數據會被發送到任何地方嗎?
不。本技能只包含文檔。您的 MCP 伺服器在本地運行並控制所有數據流動。
為什麼我的伺服器無法連接?
檢查命令路徑,驗證依賴項已安裝,並確保您的 list_tools() 返回有效的 JSON schema。
這與官方伺服器有何不同?
這裡提供模式和範例。官方伺服器是預構建的實現,適用於特定服務如檔案系統或 GitHub。

تفاصيل المطور

المؤلف

0xDarkMatter

الترخيص

MIT

مرجع

main