/ الدليل / الملعب / Desktop Commander
← كل الخوادم ↗ GitHub
● مجتمع wonderwhy-er ⚡ فوري

Desktop Commander

بواسطة wonderwhy-er · wonderwhy-er/DesktopCommanderMCP

امنح Claude طرفية حقيقية — عمليات الملفات، تعديل الكود، إدارة العمليات، وتنفيذ الأوامر عبر نظام الملفات بالكامل مع بوابات صلاحيات.

Desktop Commander هو خادم MCP الذي يحوّل Claude Desktop إلى عميل برمجي بدون الحاجة إلى Claude Code أو Cursor. يتيح قراءة وكتابة نظام الملفات، التعديلات الجراحية للنصوص، تنفيذ أوامر الطرفية، إدارة العمليات طويلة الأمد، وقوائم مسموح بها للمجلدات عبر الإعدادات. يستخدمه مئات الآلاف من المطورين كبديل مجاني لبيئات التطوير التفاعلية المدفوعة.

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

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

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

عرض مباشر

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

desktop-commander-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "desktop-commander-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "desktop-commander-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@wonderwhy-er/desktop-commander"
        ]
      }
    }
  }
}

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

claude mcp add desktop-commander-mcp -- npx -y @wonderwhy-er/desktop-commander

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

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

استخدامات عملية: Desktop Commander

استخدام Claude Desktop كعميل برمجي مجاني بدون Cursor أو Claude Code

👤 المطورون الراغبون في برمجة تفاعلية بدون الاشتراك في بيئات التطوير ⏱ ~20 min beginner

متى تستخدمه: لديك Claude Desktop بالفعل وتريده أن يعدّل مستودعك فعلياً لا مجرد لصق مقتطفات.

المتطلبات الأساسية
  • تثبيت Claude Desktop — حمّله من claude.ai/download
  • إدراج مجلد العمل في القائمة البيضاء — عند التشغيل الأول يُطلب تحديد المجلدات التي يمكن لـ Claude الوصول إليها
الخطوات
  1. التثبيت وتقييد مساحة العمل
    Install desktop-commander. Limit it to ~/Code/myproject — nothing outside.✓ تم النسخ
    → يظهر الإعداد مع تقييد allowed_directories؛ وتظهر قائمة الأدوات في Claude
  2. تطبيق تغيير حقيقي
    Open ~/Code/myproject. Find every TODO comment, group by file, propose fixes for the top 5.✓ تم النسخ
    → مسح سريع بأسلوب ripgrep مع قائمة مرتبة وأرقام الأسطر
  3. التطبيق بواسطة edit_block
    Apply the proposed fixes using edit_block. Don't rewrite whole files — just the necessary diffs.✓ تم النسخ
    → يُظهر كل تعديل كتل old_string/new_string؛ git diff نظيف بعد ذلك

النتيجة: يكتب Claude Desktop تغييرات حقيقية في مستودعك بجودة مساعد بيئة التطوير المدفوعة.

المزالق
  • نسيت ضبط allowed_directories — يمسح Claude مجلد home بالكامل — عدّل ملف ~/.claude-server-commander/config.json وأعد تشغيل Claude Desktop
اجمعها مع: github · filesystem

تشغيل خوادم التطوير والتقاط مخرجاتها دون تعطيل المحادثة

👤 المطورون الذين يصحّحون أخطاء إعدادات متعددة العمليات ⏱ ~25 min intermediate

متى تستخدمه: تحتاج Claude إلى تشغيل خادم وتنفيذ اختبارات في طرفية أخرى وقراءة السجلات في آنٍ واحد.

الخطوات
  1. تشغيل الخادم في الخلفية
    Start npm run dev as a background process. Show me the PID.✓ تم النسخ
    → العملية تبدأ ويُعاد PID ويُلتقط تدفق المخرجات
  2. تشغيل الاختبارات عليه
    While that's running, execute the e2e suite and surface any failures.✓ تم النسخ
    → تُشغَّل الاختبارات باستقلالية مع استمرار بث الخادم
  3. فحص السجلات عند الطلب
    Show the last 100 lines of stdout from PID 12345. Anything red?✓ تم النسخ
    → شريحة من السجل مع إبراز الأخطاء

النتيجة: جلسة تصحيح أخطاء متعددة العمليات تُدار بالكامل من Claude.

المزالق
  • تستمر العملية في الخلفية بعد انتهاء المحادثة — استخدم أداة kill_process عند الانتهاء، أو أعد تشغيل Claude Desktop

إعادة هيكلة شاملة عبر مئات الملفات في جلسة واحدة

👤 المطورون الذين يُجرون هجرات على مستوى قاعدة الكود (مثل إعادة التسمية أو الإيقاف التدريجي) ⏱ ~60 min intermediate

متى تستخدمه: يتعطّل مساعد بيئة التطوير عند تغييرات تتجاوز 50 ملفاً؛ وتريد تمريرة واحدة منظّمة.

الخطوات
  1. تحديد نطاق التغيير
    Find every import of oldLib. Group by file and tell me how many changes per file.✓ تم النسخ
    → مخطط يُظهر حجم التأثير
  2. اختبار على ملف واحد أولاً
    Apply the migration to the smallest-impact file as a smoke test.✓ تم النسخ
    → ملف واحد تمت هجرته؛ الاختبارات تنجح
  3. التطبيق على دفعات
    Now apply to the next 20 files. After each batch, run lint and tell me if anything breaks.✓ تم النسخ
    → تقارير تقدم لكل دفعة مع فحص صحة

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

المزالق
  • يفشل edit_block بسبب اختلافات المسافات البيضاء — استخدم وضع البحث والاستبدال للأنماط الأصعب؛ تحقق من وضع نهايات الأسطر
اجمعها مع: github

التركيبات

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

desktop-commander-mcp + github

تعديل محلي ثم إنشاء PR

Apply the fixes via desktop-commander, then use github MCP to open a PR with a clean summary.✓ تم النسخ
desktop-commander-mcp + filesystem

مقارنة أوضاع الوصول المختلفة لنظام الملفات المعزول

Use filesystem MCP for read-only library scans and desktop-commander for actual project edits.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
execute_command command: str, timeout_ms?: int أي إجراء في الصدفة — git، npm، سكريبتات البناء 0
edit_block file_path, old_string, new_string التعديلات الجراحية — دون إعادة كتابة الملف بالكامل 0
read_file path قراءة الكود للسياق 0
write_file path, content إنشاء ملف جديد 0
search_files path, pattern البحث عن ملفات بالاسم أو النمط glob 0
search_code pattern, path? البحث في المحتوى عبر الملفات 0
list_processes () عرض ما يعمل في الجلسة 0

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

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

حصة API
غير متاح — محلي
الرموز لكل استدعاء
متغير — الملفات الكبيرة تستهلك tokens كثيرة
التكلفة المالية
مجاني (MIT)
نصيحة
استخدم search_code بدلاً من read_file حين تحتاج إلى بضعة أسطر فقط

الأمان

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

الحد الأدنى من الصلاحيات: filesystem-read filesystem-write shell-exec
تخزين بيانات الاعتماد: لا شيء — كل شيء محلي
نقل البيانات الخارجي: لا شيء — جميع الاستدعاءات محلية
لا تمنح أبدًا: Unrestricted root directory access

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

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

رفض الإذن على edit_block

أضف المجلد إلى allowed_directories في ~/.claude-server-commander/config.json

تحقق: cat the config and restart Claude Desktop
بدأت العملية لكن لا يوجد مخرجات

استخدم read_output مع PID؛ المخرجات تُخزَّن مؤقتاً ولا تُبث إلى المحادثة افتراضياً

edit_block يُبلّغ بـ 'old_string not found'

اختلاف في المسافات البيضاء أو نهايات الأسطر — أعد قراءة الملف أولاً لنسخ البايتات الدقيقة

البدائل

Desktop Commander مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Claude Code (CLI)تريد حلقة عمل تفاعلية من Anthropic مع التخطيط المدمجClaude Code أكثر صقلاً لكنه يتطلب اشتراكاً خاصاً؛ Desktop Commander مجاني
filesystem (official MCP)الوصول للقراءة فقط أو المعزول لنظام الملفات بدون تنفيذ أوامر الصدفةسطح أصغر، بدون تنفيذ أوامر

المزيد

الموارد

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

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

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