/ الدليل / الملعب / DebugMCP
← كل الخوادم ↗ GitHub
● رسمي microsoft ⚡ فوري

DebugMCP

بواسطة microsoft · microsoft/DebugMCP

DebugMCP من Microsoft يمنح Claude تحكمًا كاملًا في مصحح أخطاء VS Code — نقاط توقف، تتبع تنفيذ، فحص متغيرات عبر 9 لغات.

DebugMCP امتداد رسمي من Microsoft لـ VS Code يكشف مصحح الأخطاء في المحرر كأدوات MCP. يمكن لمساعدك الذكاء الاصطناعي استقلاليًا تشغيل جلسات تصحيح، ووضع نقاط توقف بمحتوى السطر (لا بأرقام السطور الهشة)، والخطو خلال التنفيذ، وفحص المتغيرات — عبر Python وTypeScript وJava وC# وC++ وGo وRust وPHP وRuby. محلي بالكامل، لا استدعاءات خارجية، يعمل على المنفذ 3001.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

debug-mcp-microsoft.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "debug-mcp-microsoft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "debug-mcp-microsoft",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3001/mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "debug-mcp-microsoft": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://localhost:3001/mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add debug-mcp-microsoft -- npx -y mcp-remote http://localhost:3001/mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: DebugMCP

اجعل Claude يتتبع اختبارًا فاشلًا بدلًا من قراءة طباعات

👤 مطورو الواجهة الخلفية والتطبيقات ⏱ ~15 min beginner

متى تستخدمه: اختبار يفشل دون stack trace واضح — تصحيح الأخطاء بالطباعة سيستغرق وقتًا طويلًا.

المتطلبات الأساسية
  • DebugMCP مثبّت في VS Code — Marketplace → ozzafar.debugmcpextension
  • امتداد تصحيح اللغة (مثلاً Python لملفات .py) — VS Code يطلبه تلقائيًا عند أول تشغيل
الخطوات
  1. الإعداد
    Use debugmcp. Add a breakpoint on the line assert result == expected in tests/test_orders.py.✓ تم النسخ
    → نقطة التوقف مُبلَّغ عنها؛ محتوى السطر متطابق
  2. التشغيل
    Start debugging tests/test_orders.py with the failing test.✓ تم النسخ
    → الجلسة متوقفة عند نقطة التوقف
  3. الفحص
    Show me all local variables. What's result actually contain?✓ تم النسخ
    → تفريغ للمتغيرات مع قيم ملموسة
  4. التتبع والتشخيص
    Step into the function that built result. Tell me where it diverged from expected.✓ تم النسخ
    → السبب الجذري مرتبط بالكود

النتيجة: العثور على الخطأ بالتتبع لا التخمين — دقائق بدلًا من ساعة.

المزالق
  • نقطة التوقف برقم السطر تنجرف بعد التعديلات — استخدم مطابقة محتوى السطر (DebugMCP يدعم هذا أصلًا)
اجمعها مع: filesystem

تحديد خطأ عشوائي بنقاط توقف شرطية

👤 المطورون الذين يواجهون أخطاء متقطعة ⏱ ~25 min intermediate

متى تستخدمه: الخطأ يظهر فقط بمدخلات معينة — تحتاج للتوقف عند تلك الحالة فقط.

الخطوات
  1. نقطة توقف شرطية
    Add a breakpoint at the process(order) call that fires only when order.id starts with 'EXP-'.✓ تم النسخ
    → نقطة التوقف الشرطية مثبّتة
  2. تشغيل الإعادة
    Run the integration suite. When we stop, evaluate the order DTO and the request headers.✓ تم النسخ
    → المدخل الفاشل بالضبط محدَّد

النتيجة: الخطأ العشوائي يتحول إلى خطأ عادي.

المزالق
  • تقييم الشرط يُبطئ الحلقة — ضيّق الشرط؛ اجعله نقيًا (بلا آثار جانبية)

استخدم المصحح كتوثيق لكود غير مألوف

👤 الموظفون الجدد الذين يتأهلون لفهم خدمة ⏱ ~30 min beginner

متى تستخدمه: ورثت خدمة وتدفق البيانات فيها غير واضح.

الخطوات
  1. تتبع نقطة الدخول
    Set a breakpoint at the HTTP handler for /orders. Run a sample request and step through every call until response is returned. Narrate as you go.✓ تم النسخ
    → تتبع خطوة بخطوة مع تحديد الملف:السطر

النتيجة: خريطة سلوكية للخدمة لم يلتقطها أي مخطط.

المزالق
  • التتبع يغوص عميقًا جدًا — استخدم step_over للإطارات المملة المعروفة، وstep_into للإطارات المثيرة للاهتمام فقط

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

debug-mcp-microsoft + filesystem

قراءة الكود المصدري أثناء التتبع لاتخاذ الخطوة التالية

Step into the call. While paused, show me the surrounding function via filesystem.✓ تم النسخ
debug-mcp-microsoft + github

فتح PR مع الإصلاح الذي تحققت منه عبر المصحح

We confirmed the bug. Open a PR with the fix and reference the debug session in the description.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
start_debugging fileFullPath, workingDirectory, testName?, configurationName? بدء جلسة تصحيح free
add_breakpoint fileFullPath, lineContent تحديد نقطة توقف بمحتوى الكود free
step_over (none) التقدم سطرًا واحدًا في الكود free
step_into (none) الدخول إلى الدالة المستدعاة free
get_variables_values scope: 'local'|'global'|'all' فحص الحالة عند نقطة التوقف الحالية free
evaluate_expression expression: str اختبار الفرضيات دون إعادة التشغيل free
list_breakpoints (none) مراجعة مجموعة نقاط التوقف الحالية free

التكلفة والحدود

تكلفة التشغيل

حصة API
محلي — لا حصة
الرموز لكل استدعاء
100–500 لكل إجراء تصحيح
التكلفة المالية
مجاني (MIT)
نصيحة
التتبع أرخص من تكرار حلقات طباعة-تصحيح؛ استبدل tokens بتشخيص أسرع

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: Local file read for source mapping
تخزين بيانات الاعتماد: لا شيء — لا بيانات اعتماد مطلوبة
نقل البيانات الخارجي: لا شيء — محلي بالكامل
لا تمنح أبدًا: Network exposure of port 3001

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

MCP server not detected after install

أعد تشغيل VS Code؛ تأكد من تفعيل الامتداد وأن المنفذ 3001 متاح

تحقق: curl http://localhost:3001/mcp
Language not supported

ثبّت امتداد تصحيح اللغة المناسب أولًا (مثلاً ms-python.python لـ Python)

تحقق: شغّل التصحيح يدويًا من واجهة VS Code للتأكيد
Breakpoint never hits

عدم تطابق source map — تأكد أنك تصحح نفس artifact الذي عدّلته

تحقق: افحص مسار `program` في launch.json

البدائل

DebugMCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Print / log statementsفحص سريع لمرة واحدة، بدون IDE متصلرخيص لكن بطيء في التكرار؛ يلوّث قاعدة الكود
Language-specific REPLتريد فحص ما بعد الوفاة فقطلا تتبع حي؛ أقل ثراءً من المصحح الكامل

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills