building-mcp-servers
إنشاء خوادم MCP لتكامل Claude
متاح أيضًا من: C0ntr0lledCha0s
إنشاء خوادم MCP التي تمكّن Claude و LLMs أخرى من التفاعل مع واجهات API والخدمات الخارجية من خلال أدوات مصممة بشكل جيد. يغطي هذا الدليل تطبيقات Python FastMCP و TypeScript MCP SDK مع المصادقة ونشر Docker وأنماط الاختبار.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "building-mcp-servers". إنشاء أداة خادم MCP TypeScript تبحث عن المستخدمين مع دعم التصفح
النتيجة المتوقعة:
- Tool name: example_search_users (snake_case مع بادئة الخدمة)
- مخطط الإدخال مع التحقق من Zod: استعلام string، limit 1-100، offset >= 0
- الاستجابة تشمل: total count، مصفوفة المستخدمين مع id و name و email و team، علم has_more
- التعليقات التوضيحية: readOnlyHint: true، destructiveHint: false، idempotentHint: true، openWorldHint: true
استخدام "building-mcp-servers". كيف أقوم بتكوين أمان النقل لخادم FastMCP في Docker؟
النتيجة المتوقعة:
- استيراد TransportSecuritySettings من mcp.server.transport_security
- تكوين allowed_hosts: 127.0.0.1:*، localhost:*، [::1]:*، container_name:*، 0.0.0.0:*
- تمرير معامل transport_security إلى مُنشئ FastMCP
- هذا يتحقق من صحة رؤوس Host ويمنع هجمات إعادة ربط DNS
استخدام "building-mcp-servers". ماذا يجعل سؤال تقييم MCP جيدًا؟
النتيجة المتوقعة:
- يتطلب فقط عمليات للقراءة فقط وغير مدمرة
- يتطلب استكشافًا عميقًا مع استدعاءات أدوات متعددة
- له إجابة واحدة قابلة للتحقق لن تتغير مع مرور الوقت
- يعكس حالات استخدام بشرية واقعية تساعد فيها LLMs
التدقيق الأمني
مخاطر منخفضةThis is a documentation/guide skill containing markdown reference files and utility scripts for building MCP servers. All 575 static findings are FALSE POSITIVES - the analyzer misinterprets markdown code examples as executable security issues. The scripts (evaluation.py, connections.py) are legitimate MCP evaluation utilities using standard, documented patterns.
عوامل الخطر
⚙️ الأوامر الخارجية (6)
📁 الوصول إلى نظام الملفات (1)
🌐 الوصول إلى الشبكة (3)
درجة الجودة
ماذا يمكنك بناءه
تكامل الخدمات الخارجية مع Claude
بناء خوادم MCP مخصصة لتوصيل Claude بواجهات API مثل GitHub و Slack أو Jira للتكامل السلس للخدمات
نشر خوادم MCP للإنتاج
تغليف خوادم MCP في حاويات Docker، وتكوين أمان النقل، وإعداد نقاط نهاية فحص الصحة
اختبار فعالية خادم MCP
إنشاء أطر تقييم لقياس مدى قدرة LLMs على استخدام أدوات خادم MCP الخاص بك للمهام المعقدة
جرّب هذه الموجهات
إنشاء هيكل خادم MCP أساسي في Python باستخدام FastMCP لتكامل GitHub. قم بتضمين اصطلاحات تسمية الأدوات وإعداد المصادقة.
إضافة دعم التصفح إلى أداة list_repos في خادم MCP الخاص بي. إظهار كيفية تنفيذ التصفح المستند إلى الإزاحة مع معلمات limit و offset و has_more.
تكوين خادم MCP Python الخاص بي لنشر Docker مع نقل Streamable HTTP. تضمين تكوين allowed_hosts للتواصل بين الحاويات.
إنشاء 10 أسئلة تقييم لخادم MCP الخاص بي تختبر ما إذا كان LLMs يمكنها استخدام الأدوات بفعالية للإجابة على استعلامات معقدة وواقعية حول البيانات التاريخية.
أفضل الممارسات
- استخدم تسمية أدوات متسقة مع بادئات الخدمة (github_create_issue) لتجنب التعارضات عند استخدام خوادم MCP متعددة
- نفذ التصفح مع limit و offset و has_more لمنع إرهاق LLMs بمجموعات نتائج كبيرة
- صمم أدوات بمخططات إدخال واضحة باستخدام Pydantic أو Zod للتحقق من الصحة،وفر رسائل خطأ قابلة للتنفيذ
تجنب
- تجنب أسماء أدوات عامة مثل send_message أو create التي قد تتعارض مع خوادم MCP أخرى
- لا تُرجع جميع البيانات بدون تصفح - هذا يتسبب في نفاد سياق LLMs
- تجنب الأدوات التي تعدل الحالة دون تعليقات توضيحية واضحة readOnlyHint و destructiveHint