الوصف
مدقق محلي MCP ومهندس نظام V2 هو خادم بروتوكول سياق النموذج (MCP) مفتوح المصدر يقوم بمراجعة الشيفرة وتصميمات النظام باستخدام نموذج لغوي يعمل بالكامل على جهاز المطور الخاص. يتصل بأي عميل متوافق مع MCP ويسلم كل تقديم إلى خادم LM Studio محلي بدلاً من واجهة برمجة التطبيقات السحابية، لذا لا تغادر أي شيفرة أو تصميم الجهاز ولا توجد تكلفة لكل توكن.
قراءة المزيد
يكتشف الخادم تلقائيًا ما إذا كان التقديم الوارد هو شيفرة أو مواصفة عالية المستوى ويوجهه إلى أحد الدورين. في وضع مدقق الشيفرة الإنتاجية، يتحقق من المدخلات وفقًا لعشر قواعد هندسية دفاعية تغطي المنطق وظروف الحافة مثل فحوصات القيمة الفارغة والقسمة على الصفر، تسرب الموارد ومشكلات الأداء مثل مديري السياق غير المغلقين، والحدود الدفاعية مثل تلميحات النوع وحراس الحلقات المحدودة. يعيد حكمًا حتميًا إما مُعتمد أو مرفوض مع ملاحظات قابلة للتنفيذ. في وضع مهندس النظام والاستراتيجي، الذي يتم تفعيله عندما يبدو المدخل كأنه مواصفة بدلاً من شيفرة، ينتج توبولوجيات المكونات، هياكل الدليل، نمذجة المخاطر لنقاط التزامن والفشل، وخطة تنفيذ مرحلية.
قبل أن تصل أي شيء إلى النموذج اللغوي، يقوم حارس سريع يعتمد على AST بتحليل التقديم ويمنع المكالمات عالية المخاطر مثل eval وexec وos.system وsubprocess، ويرفض بايثون غير الصحيح بشكل قاطع. يتم تسجيل كل تدقيق مرتين: كصفوف منظمة في قاعدة بيانات SQLite محلية للقياسات والتاريخ، وكسجلات JSON ذرية تهدف إلى أن تكون مجموعة بيانات للتدريب الدقيق. يمكن أن يعمل برنامج مراقب منفصل بجانب الخادم وينشر تحديثات حالة منسقة إلى قناة Discord عند ظهور ملفات تدقيق جديدة، بحيث يمكن للفريق متابعة نشاط المراجعة دون فتح لوحة التحكم. يستعلم الخادم أيضًا عن نقطة نهاية النموذج النشطة في LM Studio مباشرة، لذا يلتقط أي نموذج محمل حاليًا بدلاً من الحاجة إلى اسم نموذج محدد.
يأتي المشروع مع مقطع "بروتوكول حلقة الوكيل" جاهز يمكن للمطورين لصقه في تكوين مساعد الترميز الخاص بهم، مما يوجه المساعد لاستدعاء أداة التدقيق بعد كل تغيير في الشيفرة، قراءة ملاحظات الرفض، إصلاح المشكلات المبلغ عنها، وإعادة التقديم، مع حد أقصى لخمس محاولات.
تم بناؤه للمطورين الأفراد والفرق الصغيرة الذين يرغبون في خطوة مراجعة الشيفرة والهندسة المعمارية المؤتمتة في سير عمل الترميز القائم على MCP دون دفع تكاليف الاستدلال السحابي أو كشف الشيفرة الملكية لواجهة برمجة تطبيقات طرف ثالث. يتطلب Python 3.10 أو أحدث، ونسخة تعمل من LM Studio مع نموذج مُعدل بالتعليمات محمل، وعميل متوافق مع MCP. يتم توزيع المشروع بموجب ترخيص MIT وهو مجاني للاستخدام؛ يقبل المسؤول تبرعات اختيارية عبر Ko-fi وGitHub Sponsors.
- الفئةمراجعة الشيفرة واختبارها بالذكاء الاصطناعي
- نموذج التسعيرمفتوح المصدر
- النشريعمل محليًا
- المنصاتWindows, macOS, Linux
الميزات الأساسية لـ مدقق محلي MCP ومهندس نظام V2
خادم MCP مزدوج الوضع يكتشف تلقائيًا إدخال الشيفرة مقابل المواصفة ويوجهه إلى الدور المناسب للتدقيق
وضع مدقق الشيفرة الإنتاجية يتحقق من التقديمات وفقًا لعشر قواعد هندسية دفاعية مع حكم حتمي مُعتمد/مرفوض
وضع مهندس النظام والاستراتيجي يقوم بإعداد توبولوجيات المكونات، نماذج المخاطر وخطط التنفيذ المرحلية من المواصفات
حارس يعتمد على AST يمنع المكالمات eval وexec وos.system وsubprocess، ويرفض بايثون غير الصحيح قبل أن تصل إلى النموذج
يعمل بالكامل على خادم LM Studio محلي، لذا لا تغادر أي شيفرة جهاز المطور ولا توجد تكلفة توكن
اكتشاف ديناميكي للنموذج يقرأ أي نموذج محمل حاليًا في LM Studio
يسجل كل تدقيق في قاعدة بيانات SQLite محلية وفي ملفات JSON ذرية مناسبة لمجموعات بيانات التدريب الدقيق
برنامج مراقب Discord في الخلفية ينشر تحديثات منسقة في الوقت الحقيقي عند كتابة نتائج تدقيق جديدة
يأتي مع مقطع "بروتوكول حلقة الوكيل" الذي يجعل مساعد الترميز يصحح نفسه من خلال دورات تدقيق وإصلاح متكررة
يتضمن مجموعة pytest التي تتحقق من حارس AST، ترحيلات قاعدة البيانات وخط أنابيب الاستدلال دون الحاجة إلى نسخة حية من LM Studio
البدء مع مدقق محلي MCP ومهندس نظام V2
تثبيت LM Studio: قم بتنزيل LM Studio، تحميل نموذج مُعدل بالتعليمات، وبدء خادمه المحلي على المنفذ 1234.
استنساخ وإعداد الخادم: استنسخ المستودع، أنشئ بيئة افتراضية، وثبت التبعيات باستخدام pip.
تسجيل خادم MCP: أضف مسار برنامج جسر الخادم إلى ملف تكوين mcpServers لعميل MCP الخاص بك.
تشغيل تدقيق: قدم شيفرة أو مواصفة من خلال أداة التدقيق؛ يختار الخادم تلقائيًا وضع مدقق الشيفرة أو المهندس.
مراجعة الحكم: اقرأ حالة مُعتمد أو مرفوض والملاحظات، ثم قم بالإصلاح وإعادة التقديم إذا تم الرفض.
اختياري، مراقبة النشاط: قم بتشغيل برنامج المراقب للحصول على إشعارات Discord لكل نتيجة تدقيق جديدة.
حالات استخدام مدقق محلي MCP ومهندس نظام V2
- بوابة مراجعة الشيفرة المحلية
- تخطيط الهندسة المعمارية
- وكيل ترميز يصحح نفسه
- رؤية تدقيق الفريق
