خادم مصحح أخطاء MCP من Fatmike

مقدمة

هذا المشروع هو خادم مصحح أخطاء MCP خفيف الوزن مبني ذاتيًا، تم تطويره للتعلم والتجريب. يعرض خادم مصحح أخطاء MCP وظائف التصحيح كأدوات MCP، مما يمكّن عملاء MCP الخارجيين من التحكم في التنفيذ، وفحص الذاكرة، وتحليل البرنامج المُصحَّح من خلال واجهة نظيفة.

المصحح مكتوب بلغة c++ وينفّذ وظائف التصحيح الأساسية من الصفر دون الاعتماد على أُطر عمل تصحيح الأخطاء الموجودة. لفك ترميز التعليمات، يُستخدم مفكك التعليمات Zydis. المصحح متكامل مع خادم MCP مكتوب بلغة c#، مبني باستخدام SDK MCP الرسمي لـ C#.

الكلمات المفتاحية:
خادم MCP، مصحح أخطاء، مفكك تعليمات، تحليل ثابت، تحليل ديناميكي، تصحيح أخطاء، ذكاء اصطناعي، EXE، ملف تنفيذي، Windows

عرض توضيحي

تم استخدام Gemini CLI كعميل MCP في العرض التوضيحي

البدء السريع: إعداد MCP.Server.exe في VS Code

يوفّر هذا الدليل عملية خطوة بخطوة لبناء ودمج MCP.Server.exe في Visual Studio Code على نظام Windows.

الخطوة 1: بناء الحل

قبل تكوين VS Code، يجب عليك ترجمة خادم MCP:

1. افتح MCPDebugger.sln في Visual Studio.
2. قم ببناء الحل
3. تأكد من أن MCP.Server.exe موجود في مجلدك الفرعي \build\Release\x86 أو \build\Release\x64.

الخطوة 2: تثبيت إضافات VS Code المطلوبة

تأكد من تثبيت الإضافات التالية وتفعيلها في VS Code:

• GitHub Copilot
• GitHub Copilot Chat

الخطوة 3: إضافة خادم MCP

1. اضغط Ctrl + Shift + P لفتح لوحة الأوامر.
2. اكتب > واختر "إضافة خادم MCP".
3. اختر command (stdio) كنوع الخادم.

الخطوة 4: تكوين المسار

أدخل المسار الكامل إلى MCP.Server.exe الذي قمت ببنائه في الخطوة 1.

[!CAUTION] يجب أن تكون بنية واحدة فقط (x86 أو x64) نشطة كخادم MCP في كل مرة. إذا قمت بتبديل البنية، فقم بإزالة إدخال الخادم السابق أولًا.

الخطوة 5: الإنهاء والاستخدام

1. تسمية الخادم: أدخل اسمًا لخادم MCP واضغط Enter.
2. التحقق: افتح Copilot Chat (Ctrl + Alt + I)، وبدّل إلى وضع الوكيل، ثم انقر على أيقونة الأدوات. يجب أن تكون أدوات MCP الخاصة بك الآن مدرجة وجاهزة للاستخدام. يمكن تمكين / تعطيل أدوات MCP هنا.

لقطات شاشة VS Code

VS Code: شريط الأدوات مع الإضافات المثبتة وخادم MCP

VS Code: نافذة Copilot Chat

توصيات النماذج

بالنسبة للمهام المعقدة في التصحيح والهندسة العكسية باستخدام مصحح أخطاء MCP هذا، قدّم Claude Opus 4.5 أفضل النتائج بفارق كبير اعتبارًا من نوفمبر 2025. لقد تعامل باستمرار مع سجلات التنفيذ الكبيرة، والتفكيك المفصّل، والاستدلال متعدد الخطوات بشكل أكثر موثوقية من النماذج الأخرى المختبرة.

كان ChatGPT 4.1 وGemini 2.5 Pro كافيين لسيناريوهات التحليل الأبسط، مثل التنفيذ الأساسي خطوةً بخطوة، وفحص التعليمات، والاستدلال المباشر حول تدفق التحكم. وقد أدّت هذه النماذج أداءً جيدًا مع الأمثلة المقدمة في مجلدَي Example_x64 وExample_x86، لكنها أظهرت قيودًا عند التعامل مع جلسات تصحيح أخطاء أكثر تعقيدًا أو طويلة الأمد.

قد يتغير أداء النماذج بمرور الوقت، لكن ما سبق يعكس السلوك المرصود وقت الاختبار.

إخلاء مسؤولية

يمكن أن يؤدي التصحيح عبر MCP إلى استهلاك عالٍ للرموز وتكاليف متزايدة. التفاعلات مع الذكاء الاصطناعي عديمة الحالة، مما يعني أن جميع سياقات التصحيح ذات الصلة (السجلات، الذاكرة، التفكيك، الوحدات، إلخ) يجب نقلها بشكل متكرر مع كل طلب.

العمليات التي توقف التنفيذ بشكل متكرر وتُرجع حالة مفصّلة—مثل التنفيذ خطوة بخطوة ونقاط التوقف المؤقتة—يمكن أن تضخّم استهلاك الرموز بشكل كبير.

إذا تطلّب الأمر تكلفة منخفضة، فمن المستحسن بشدة التركيز على التحليل الثابت وتعطيل أدوات MCP التالية:

• Debugger_ContinueToBreakpoint
• Debugger_ContinueToApiBreakpoint
• Debugger_StepInto
• Debugger_StepOver

يقلل تعطيل هذه الأدوات من مقدار نقل الحالة المتكرر ويساعد على إبقاء استهلاك الرموز تحت السيطرة.

أمثلة

يحتوي المستودع على مشاريع أمثلة للمساعدة على البدء في التحليل الثابت والتصحيح، وهي موجودة في المجلدات التالية:

• Example_x64 وExample_x86
  يوفّر المشروعان Example_x64 وExample_x86 تطبيق وحدة تحكم بسيط يُستخدم كهدف تمهيدي للتصحيح. يطلب التطبيق من المستخدم إدخال كلمة مرور في وقت التشغيل. كلمة المرور الصحيحة لكلا المثالين هي secret.

• MCP_Debugging_Sessions
  مجلد يحتوي على جلسات تصحيح أخطاء أكثر تعقيدًا تستفيد من التحليل الديناميكي والتصحيح. في هذه الجلسات تم استخدام Claude Opus 4.5. يمكن تنزيل الأهداف هنا. يرجى ملاحظة أنه تم فك تعبئة الأهداف باستخدام UPX -d قبل استخدام مصحح أخطاء MCP.

أدوات MCP

يعرض خادم MCP الأدوات التالية للتفاعل مع المصحح:

دورة حياة المصحح

• Debugger_Start
  يبدأ المصحح للملف القابل للتنفيذ المحدد ويتوقف عند نقطة توقف النظام الأولية.

• Debugger_Stop
  يوقف المصحح وينهي عملية البرنامج المُصحَّح.

التحكم في التنفيذ

• Debugger_Continue
  يستأنف التنفيذ عندما يكون البرنامج المُصحَّح متوقفًا عند نقطة توقف.

• Debugger_ContinueToEntryPoint
  يستأنف التنفيذ من نقطة توقف النظام إلى نقطة دخول البرنامج.

• Debugger_ContinueToBreakpoint
  يستأنف التنفيذ حتى الوصول إلى نقطة توقف مؤقتة عند عنوان افتراضي محدد.

• Debugger_ContinueToApiBreakpoint
  يستأنف التنفيذ حتى الوصول إلى نقطة توقف مؤقتة على دالة API محددة.

• Debugger_StepInto
  ينفّذ التعليمة التالية مع الدخول إلى استدعاءات الدوال.

• Debugger_StepOver
  يتجاوز استدعاءات الدوال ويستمر إلى التعليمة التالية.

فحص الكود والذاكرة

• Debugger_Disassemble
  يفكك الذاكرة عند عنوان افتراضي معين ويعيد التعليمات بما في ذلك معلومات الرموز.

• Debugger_TryResolveString
  يحاول تحليل وقراءة سلسلة نصية من ذاكرة البرنامج المُصحَّح.

• Debugger_ReadMemory
  يقرأ وحدات البايت الخام من ذاكرة عملية البرنامج المُصحَّح.

• Debugger_WriteMemory
  يكتب وحدات بايت عشوائية في ذاكرة البرنامج المُصحَّح.

فحص الوحدات

• Debugger_GetModules
  يعيد قائمة بالوحدات المحمّلة حاليًا في عملية البرنامج المُصحَّح.

• Debugger_GetModuleImports
  يعيد الدوال المستوردة لوحدة محددة.

• Debugger_GetModuleExports
  يعيد الدوال المُصدَّرة لوحدة محددة.

• Debugger_GetModuleSections
  يعيد معلومات أقسام وحدة محددة.

أدوات مساعدة

• Debugger_HexToDecConverter
  يحوّل القيم السداسية العشرية إلى عشرية لتجنب أخطاء تحويل الأرقام.

نظرة عامة على الحل

يتكوّن حل Visual Studio من المشاريع التالية:

• MCP.Debugger
  المصحح الأساسي المنفَّذ بلغة C++. يتضمن جسر C++/CLI لتوفير واجهة مُدارة لعملاء .NET.

• MCP.Debugger.Tester
  تطبيق WinForms بسيط يُستخدم لاختبار المصحح عبر واجهة .NET المُدارة.

• MCP.Debugger.Types
  تجميعة أنواع تُعرّف البنى المشتركة وأنواع البيانات للانتقالات بين الكود المُدار والكود الأصلي بين المصحح وعملاء .NET.

• MCP.Server
  خادم MCP بلغة C# يعرض وظائف المصحح كأدوات MCP للعملاء الخارجيين.