ماذا يفعل خادم MCP “ssh-mcp-server”؟

يعد ssh-mcp-server أداة وسيطة تمكّن المساعدات الذكية والتطبيقات الأخرى الداعمة لبروتوكول سياق النماذج (MCP) من تنفيذ أوامر SSH عن بُعد عبر واجهة موحدة. من خلال عمله كوسيط آمن، يسمح للمساعدات الذكية بالتحكم في الخوادم البعيدة، تنفيذ الأوامر، وجلب النتائج دون كشف بيانات اعتماد SSH مباشرة لنماذج الذكاء الاصطناعي. يدعم الخادم عدة طرق اتصال SSH آمنة تشمل المصادقة بكلمة المرور أو المفتاح الخاص (مع دعم اختياري للعبارة السرية). كما يوفر ضوابط أمان للأوامر عبر آليات القوائم البيضاء والسوداء، ويمكّن نقل الملفات في الاتجاهين بين الخادم المحلي والبعيد. تم تصميم ssh-mcp-server ليتم دمجه بسلاسة في سير عمل التطوير، ليمنح المطورين ووكلاء الذكاء الاصطناعي وصولاً قويًا ومضبوطًا إلى الأنظمة البعيدة لمهام مثل الصيانة، والأتمتة، والنشر.

قائمة القوالب

لا توجد قوالب أوامر مذكورة صراحة في الوثائق المتاحة.

قائمة الموارد

لا توجد موارد موثقة صراحة في الملفات أو ملف README المتاح.

قائمة الأدوات

• execute-command
  أداة تنفيذ الأوامر: تنفيذ أوامر SSH على الخوادم البعيدة والحصول على النتائج.
• upload
  أداة رفع الملفات: رفع الملفات المحلية إلى أماكن محددة على الخوادم البعيدة.
• download
  أداة تنزيل الملفات: تنزيل الملفات من الخوادم البعيدة إلى أماكن محددة محليًا.

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

• إدارة الخوادم عن بُعد
  تمكّن المطورين أو وكلاء الذكاء الاصطناعي من تنفيذ أوامر إدارية أو صيانة على الخوادم البعيدة بشكل آمن، مثل إعادة تشغيل الخدمات، فحص السجلات، أو تحديث البرمجيات.
• النشر الآلي
  تسهل خطوط النشر الآلي من خلال السماح للبرمجيات أو تدفقات الذكاء الاصطناعي بدفع الشيفرة، تشغيل نصوص الإعداد، أو إدارة التطبيقات عبر SSH.
• مزامنة الملفات
  تدعم نقل الملفات في الاتجاهين، مما يجعل من السهل رفع ملفات الإعدادات أو تنزيل السجلات والنتائج من الخوادم البعيدة.
• التدقيق الأمني
  تتيح تنفيذ أوامر تدقيق محددة (باستخدام القائمة البيضاء/السوداء)، لإجراء فحوصات أمان وامتثال بشكل آمن دون خطر الإضرار بالنظام.
• عزل بيانات الاعتماد
  تسمح بالتشغيل الآمن من خلال ضمان عدم كشف بيانات اعتماد SSH لنموذج الذكاء الاصطناعي، مما يقلل المخاطر في البيئات الحساسة.

كيفية إعداده

Windsurf

1. المتطلبات الأساسية: تأكد من تثبيت Node.js و npx.
2. تحديد الإعدادات: افتح ملف إعدادات Windsurf الخاص بك.
3. إضافة خادم MCP: أضف المقطع التالي بصيغة JSON داخل كائن mcpServers:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456"
         ]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ الملف وأعد تشغيل Windsurf.
5. التحقق من الإعداد: اختبر عبر تنفيذ أمر SSH بسيط من خلال واجهة MCP.

Claude

1. المتطلبات الأساسية: يجب توفر Node.js و npx.
2. تحديد الإعدادات: افتح إعدادات mcpServers في Claude.
3. إضافة خادم MCP: استخدم الإعداد التالي:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa"
         ]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ التغييرات وأعد تشغيل Claude.
5. التحقق من الإعداد: جرب أمرًا اختباريًا عبر تكامل MCP في Claude.

Cursor

1. المتطلبات الأساسية: ثبت Node.js و npx.
2. تحرير الإعدادات: انتقل إلى مجلد إعدادات Cursor وعدل الملف المناسب.
3. إضافة خادم MCP: أضف:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa",
           "--passphrase pwd123456"
         ]
       }
     }
   }
   

4. إعادة تشغيل Cursor: احفظ الملف وأعد تشغيل Cursor.
5. التحقق: استخدم لوحة أوامر MCP للتحقق من اتصال SSH البعيد.

Cline

1. المتطلبات الأساسية: تأكد من تثبيت Node.js و npx.
2. فتح الإعداد: عدل قسم mcpServers في إعدادات Cline.
3. إضافة خادم MCP: أضف:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456",
           "--whitelist ^ls( .*)?,^cat .*,^df.*"
         ]
       }
     }
   }
   

4. الحفظ وإعادة التشغيل: احفظ الإعدادات وأعد تشغيل Cline.
5. اختبار الاتصال: تحقق بتنفيذ أمر مسموح به.

تأمين مفاتيح API

لتجنب كشف بيانات الاعتماد في ملفات الإعدادات، استخدم متغيرات البيئة:

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host ${SSH_HOST}",
        "--port ${SSH_PORT}",
        "--username ${SSH_USER}",
        "--password ${SSH_PASSWORD}"
      ],
      "env": {
        "SSH_HOST": "192.168.1.1",
        "SSH_PORT": "22",
        "SSH_USER": "root",
        "SSH_PASSWORD": "pwd123456"
      }
    }
  }
}

كيفية استخدام MCP هذا داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt، ابدأ بإضافة مكوّن MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكوّن MCP لفتح لوحة الإعدادات. في قسم إعدادات MCP للنظام، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق لـ JSON:

{
  "ssh-mpc-server": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، يصبح الوكيل الذكي قادرًا على استخدام هذا MCP كأداة مع الوصول إلى جميع وظائفه وقدراته. تذكر تغيير “ssh-mpc-server” إلى اسم خادم MCP الفعلي الخاص بك وتحديث عنوان URL.

نظرة عامة

رأينا

يوفر ssh-mcp-server وظائف SSH أساسية كخادم MCP مع التركيز على الأمان والملاءمة. مجموعة أدواته عملية لكثير من سيناريوهات التطوير والأتمتة، لكنه يفتقر إلى ميزات متقدمة مثل الموارد، قوالب الأوامر، أو دعم التعيين. الوثائق واضحة للإعداد والاستخدام التشغيلي. بشكل عام، يعد أداة متخصصة وقوية للوصول الآمن عبر MCP.

تقييم MCP

التقييم: 5/10

يحصل ssh-mcp-server على تقييم متوسط، حيث يتفوق في تكامل SSH الآمن وتوفير الأدوات الأساسية، لكنه يفتقر إلى دعم الموارد والقوالب ولا يذكر الجذور أو ميزات التعيين. رخصته مفتوحة المصدر وسهولة إعداده من الجوانب الإيجابية، لكنه يظل حلاً مركزًا غير شامل لخوادم MCP.