Desktop Commander MCP هو خادم MCP مصمم لـ Claude، يمنحه القدرة على التحكم في المحطة الطرفية والبحث في نظام الملفات وتحرير الملفات المختلفة.

مشروع Desktop Commander MCP: تفاصيل المشروع

نظرة عامة على المشروع

Desktop Commander MCP هو أداة خادم تعتمد على بروتوكول سياق النموذج (MCP)، مصممة خصيصًا لتطبيق Claude Desktop. من خلال بروتوكول MCP، يوفر هذا المشروع لـ Claude القدرة على التحكم في المحطة الطرفية، والبحث في نظام الملفات، وتحرير الملفات بشكل تفاضلي، مما يحول Claude إلى مساعد تطوير قوي.

يقوم هذا المشروع بتوسيع وظائف خادم نظام الملفات MCP، مما يمكّن المطورين من تشغيل النظام المحلي مباشرةً من خلال Claude، وتنفيذ الأوامر، وإدارة الملفات، وإجراء تعديلات على التعليمات البرمجية، متجاوزًا قدرات محررات الذكاء الاصطناعي التقليدية.

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

🖥️ عمليات المحطة الطرفية

• تنفيذ الأوامر: تنفيذ أوامر المحطة الطرفية ودعم تدفق الإخراج
• التحكم في المهلة: مهلة قابلة للتكوين للأوامر ودعم التنفيذ في الخلفية
• إدارة العمليات: سرد وإنهاء العمليات قيد التشغيل
• إدارة الجلسات: دعم إدارة الجلسات للأوامر طويلة الأمد
• دعم Shell المتعدد: دعم بيئات Shell المختلفة مثل bash و zsh و powershell

📁 عمليات نظام الملفات

• قراءة وكتابة الملفات: وظائف كاملة لقراءة وكتابة الملفات
• إدارة الدليل: إنشاء وسرد ونقل الملفات والأدلة
• البحث عن الملفات: وظيفة البحث المستندة إلى اسم الملف
• الحصول على البيانات الوصفية: الحصول على معلومات تفصيلية عن الملفات والأدلة
• دعم ملفات متعددة: قراءة ملفات متعددة في وقت واحد
• قراءة محتوى URL: دعم قراءة النصوص والصور من عناوين URL

✏️ قدرات تحرير التعليمات البرمجية

• استبدال دقيق: استبدال نص جراحي للتعديلات الصغيرة
• إعادة كتابة كاملة: إعادة كتابة كاملة للملفات للتغييرات الكبيرة
• دعم ملفات متعددة: تحرير ملفات متعددة في وقت واحد
• استبدال النمط: استبدال النص المستند إلى النمط
• البحث عن التعليمات البرمجية: استخدام vscode-ripgrep للبحث المتكرر عن التعليمات البرمجية أو النص

⚙️ إدارة تكوين الخادم

• الحصول على/تعيين التكوين: الحصول على وتعيين قيم التكوين
• تحديث مجمّع: تحديث إعدادات متعددة مرة واحدة
• التكوين الديناميكي: إجراء تغييرات في التكوين دون الحاجة إلى إعادة تشغيل الخادم
• التحكم الأمني: دعم حظر أوامر معينة وتقييد الوصول إلى الدليل

طرق التثبيت

الطريقة الأولى: تثبيت سريع باستخدام NPX (موصى به)

npx @wonderwhy-er/desktop-commander@latest setup

الطريقة الثانية: تثبيت تلقائي لنظام macOS

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

الطريقة الثالثة: التثبيت باستخدام Smithery

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

الطريقة الرابعة: التثبيت اليدوي

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

تصنيف الأدوات الرئيسية

أدوات إدارة التكوين

• get_config: الحصول على تكوين الخادم الكامل
• set_config_value: تعيين قيمة تكوين معينة

أدوات المحطة الطرفية

• execute_command: تنفيذ أمر المحطة الطرفية
• read_output: قراءة الإخراج الجديد لجلسة قيد التشغيل
• force_terminate: فرض إنهاء جلسة قيد التشغيل
• list_sessions: سرد جميع جلسات المحطة الطرفية النشطة
• list_processes: سرد جميع العمليات قيد التشغيل
• kill_process: إنهاء العملية عن طريق PID

أدوات نظام الملفات

• read_file: قراءة ملف محلي أو محتوى URL
• read_multiple_files: قراءة ملفات متعددة في وقت واحد
• write_file: استبدال محتوى الملف بالكامل
• create_directory: إنشاء دليل
• list_directory: الحصول على قائمة تفصيلية بالدليل
• move_file: نقل أو إعادة تسمية الملفات والأدلة
• search_files: البحث عن الملفات بالاسم
• search_code: البحث عن أنماط النص/التعليمات البرمجية في محتوى الملف
• get_file_info: الحصول على بيانات وصفية تفصيلية للملف أو الدليل

أدوات تحرير النصوص

• edit_block: تطبيق استبدال نص جراحي

المزايا التقنية

مقارنة بأدوات IDE التقليدية

• حل على مستوى النظام بالكامل: لا يقتصر على بيئة IDE، بل يمكنه تشغيل نظام التشغيل بأكمله
• قراءة كاملة للملفات: يمكن لـ Claude قراءة الملفات بالكامل، بدلاً من معالجتها على شكل أجزاء
• دعم مشاريع متعددة: يمكنه التعامل مع مشاريع متعددة في وقت واحد
• تنفيذ لمرة واحدة: يمكنه تنفيذ التغييرات مرة واحدة، مما يقلل من التأكيد المتكرر

فعالية التكلفة

• يعتمد على اشتراك Claude Desktop Pro القياسي (20 دولارًا شهريًا)
• لا توجد رسوم إضافية لاستدعاء واجهة برمجة التطبيقات (API)
• آلية تحديث تلقائية، يتم الحصول على أحدث إصدار تلقائيًا عند التثبيت عبر NPX أو Smithery

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

سيناريوهات التطوير

• استكشاف وفهم قواعد التعليمات البرمجية المعقدة
• إنشاء الرسوم البيانية والوثائق
• أتمتة المهام عبر الأنظمة
• العمل على مشاريع متعددة في وقت واحد
• تعديل التعليمات البرمجية بدقة

ميزات الأمان

• قائمة قابلة للتكوين بالأوامر المحظورة
• التحكم في الوصول إلى الدليل المسموح به
• إدارة ومراقبة العمليات
• استمرار التكوين والتحقق من صحته