MCP Interface Validator

# مُدقق واجهة MCP - قيود واجهة ذكية والتحقق [](https://github.com/xiaoxiaofeiya/mcp-interface-validator) [](https://www.npmjs.com/package/mcp-interface-validator) ## ❌ بدون مُدقق واجهة MCP قد يحتوي الكود المُولد بواسطة الذكاء الاصطناعي للواجهة الأمامية والخلفية على مشاكل عدم تطابق الواجهة: - ❌ استدعاءات API للواجهة الأمامية لا تتطابق مع تطبيقات الواجهة الخلفية - ❌ تعريفات هيكل البيانات غير المتسقة تسبب أخطاء وقت التشغيل - ❌ نقص مواصفات الواجهة الموحدة، مما يجعل التعاون الجماعي صعباً - ❌ فحص تطابق الواجهة اليدوي غير فعال ## ✅ مع مُدقق واجهة MCP يتحقق مُدقق واجهة MCP تلقائياً من تطابق الواجهة بين كود الواجهة الأمامية والخلفية المُولد بواسطة الذكاء الاصطناعي باستخدام مواصفات OpenAPI 3.0. أضف `.use interface` إلى مطالباتك في Cursor: ```txt تطوير نظام تسجيل دخول المستخدم مع نموذج الواجهة الأمامية وAPI الواجهة الخلفية. .use interface ``` ```txt إنشاء وحدة إدارة المنتجات مع عمليات CRUD. .use interface ``` سيقوم مُدقق واجهة MCP بـ: - 🔍 **حقن القيود الذكية** - إضافة قيود التحقق من الواجهة تلقائياً إلى مطالبات الذكاء الاصطناعي - 📋 **التحقق من مواصفات OpenAPI** - ضمان اتباع الكود المُولد لمواصفات API - 🔄 **فحص الواجهة في الوقت الفعلي** - التحقق من تطابق واجهة الواجهة الأمامية-الخلفية - 🛠️ **دعم متعدد الأدوات** - دعم Cursor وWindsurf وTrae وAugment وأدوات الذكاء الاصطناعي الأخرى ## 🚀 الميزات الأساسية ### نظام القيود الذكية - **أمر `.use interface`** - تفعيل بنقرة واحدة لقيود التحقق من الواجهة - **حقن المطالبات التلقائي** - التعرف الذكي وحقن مطالبات قيود OpenAPI - **دعم متعدد اللغات** - دعم الأوامر الصينية والإنجليزية - **معالجة التعليمات الضبابية** - التعامل مع تعليمات المستخدم غير الدقيقة ### محرك التحقق من الواجهة - **دعم OpenAPI 3.0** - التحقق الكامل من مواصفات Swagger - **التحقق في الوقت الفعلي** - فحص الواجهة في الوقت الفعلي أثناء توليد الكود - **تقارير الأخطاء** - تقارير مفصلة عن عدم تطابق الواجهة - **اقتراحات الإصلاح التلقائي** - تقديم اقتراحات إصلاح الواجهة ## 🛠️ البدء السريع ### المتطلبات - Node.js >= v18.0.0 - أدوات الذكاء الاصطناعي التي تدعم بروتوكول MCP (Cursor، Windsurf، Claude Desktop، إلخ) ### التثبيت العام ```bash npm install -g mcp-interface-validator ``` ### التثبيت من GitHub ```bash npm install -g https://github.com/xiaoxiaofeiya/mcp-interface-validator.git ``` ## 📦 إعداد التكوين ### التكوين في Cursor أضف التكوين التالي إلى ملف `~/.cursor/mcp.json`: ```json { "mcpServers": { "interface-validator": { "command": "mcp-interface-validator", "args": [] } } } ``` ### التكوين في Claude Desktop أضف ما يلي إلى `claude_desktop_config.json`: ```json { "mcpServers": { "interface-validator": { "command": "mcp-interface-validator", "args": [] } } } ``` ## 🎯 الاستخدام ### الاستخدام الأساسي 1. **تفعيل القيود الذكية**: أضف `.use interface` إلى مطالبات الذكاء الاصطناعي 2. **وصف المتطلبات**: اوصف احتياجات التطوير بشكل طبيعي 3. **التحقق التلقائي**: يحقن النظام قيود التحقق من الواجهة تلقائياً 4. **الحصول على النتائج**: احصل على كود يتوافق مع مواصفات OpenAPI ### سيناريوهات الأمثلة **نظام إدارة المستخدمين**: ```txt تطوير وظائف تسجيل المستخدم وتسجيل الدخول مع التحقق من نموذج الواجهة الأمامية وAPI الواجهة الخلفية. .use interface ``` **وحدة إدارة المنتجات**: ```txt إنشاء عمليات CRUD للمنتجات، الواجهة الأمامية باستخدام React، الواجهة الخلفية باستخدام Express. .use interface ``` ## 🔧 التكوين المتقدم ### قواعد القيود المخصصة إنشاء ملف `constraint-config.json`: ```json { "openapi": { "version": "3.0.0", "strictMode": true, "validateResponses": true }, "validation": { "realTime": true, "autoFix": true } } ``` ## 📚 روابط الوثائق - [دليل النشر الكامل](./COMPLETE-DEPLOYMENT-GUIDE.md) - [دليل القيود الذكية](./INTELLIGENT-VALIDATION-GUIDE.md) - [استكشاف الأخطاء وإصلاحها](./TROUBLESHOOTING.md) ## 🌟 المزايا الرئيسية - **بدء بدون تكوين** - جاهز للاستخدام بعد التثبيت - **التعرف الذكي** - التعرف التلقائي على متطلبات التحقق من الواجهة - **ردود الفعل في الوقت الفعلي** - فحص تطابق الواجهة الفوري - **دعم متعدد المنصات** - دعم كامل لـ Windows وmacOS وLinux - **مفتوح المصدر ومجاني** - ترخيص MIT، مفتوح المصدر بالكامل ## 🤝 المساهمة المشاكل وطلبات السحب مرحب بها! ## 📄 الترخيص ترخيص MIT - انظر ملف [LICENSE](../LICENSE) للتفاصيل