خادم ملفات MCP

ماذا يفعل خادم “نظام الملفات” MCP؟

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

قائمة المطالبات

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

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

لا توجد “موارد” MCP صريحة موثقة في المستودع. يركز الخادم على توفير عمليات نظام الملفات كأدوات.

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

• read_file
  قراءة كامل محتوى ملف من نظام الملفات.
• read_multiple_files
  قراءة محتويات عدة ملفات في عملية واحدة.
• write_file
  إنشاء ملف جديد أو الكتابة فوق ملف موجود بمحتوى جديد.
• copy_file
  نسخ الملفات والمجلدات.
• move_file
  نقل أو إعادة تسمية الملفات والمجلدات.
• delete_file
  حذف ملف أو مجلد من نظام الملفات، مع إمكانية الحذف التكراري.
• modify_file
  إيجاد واستبدال نص داخل ملف باستخدام المطابقة النصية أو التعبيرات النمطية.
• list_directory
  سرد جميع الملفات والمجلدات في مسار محدد.
• create_directory
  إنشاء مجلد جديد أو التأكد من وجود مجلد.
• tree
  إرجاع تمثيل JSON هرمي لبنية مجلد.
• search_files
  البحث التكراري عن الملفات والمجلدات المطابقة لنمط معين.
• search_within_files
  البحث عن نص داخل محتويات الملفات عبر بنية مجلدات.
• get_file_info
  استرجاع بيانات وصفية مفصلة عن ملف أو مجلد.
• list_allowed_directories
  إرجاع قائمة المجلدات التي يُسمح للخادم بالوصول إليها.

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

• استكشاف قواعد الشيفرة تلقائيًا
  يمكن للمطورين ووكلاء الذكاء الاصطناعي استكشاف مجلدات المشاريع بسرعة، وسرد الملفات، والبحث عن أنماط الشيفرة أو أنواع الملفات.
• تحرير الملفات المجمع
  استخدم أداة modify_file لإجراء عمليات البحث والاستبدال—سواء بالنص العادي أو التعبيرات النمطية—عبر عدة ملفات لتحرير فعال للشيفرة أو النصوص.
• إدارة الملفات الآمنة
  يوفر بيئة مضبوطة للقراءة والكتابة والنقل والنسخ أو حذف الملفات ضمن مجلدات محددة، مثالية للأتمتة دون تعريض النظام لخطر.
• البحث واكتشاف المحتوى
  تحديد مواقع الملفات أو المجلدات المطابقة لأنماط معينة أو التي تحتوي على محتوى محدد بسرعة، مما يدعم مهام التوثيق أو إعادة هيكلة الشيفرة أو البحث.
• النسخ الاحتياطي أو التنظيم التلقائي
  استخدم أدوات copy_file وmove_file وtree لأتمتة إجراءات النسخ الاحتياطي، أو إعادة تنظيم بنية المشاريع، أو عكس تخطيطات المجلدات.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Go وتوفر ملف خادم ملفات MCP.

2. افتح ملف إعدادات Windsurf.

3. أضف خادم MCP عبر المقطع التالي من JSON:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. احفظ الإعدادات وأعد تشغيل Windsurf.

5. تحقق من ظهور خادم “filesystem” ضمن تكاملات MCP.

تأمين مفاتيح API (مثال باستخدام متغيرات البيئة)

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Claude

1. حمّل وركب خادم ملفات MCP.

2. حدّد ملف إعدادات Claude الخاص بتكامل MCP.

3. أدخل تسجيل الخادم كما يلي:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. احفظ وأعد تشغيل Claude.

5. تحقق من أن خادم ملفات MCP نشط.

Cursor

1. ثبّت ملف الخادم باستخدام Go أو من الإصدار.

2. افتح إعدادات Cursor أو ملف الإعدادات الخاص بـ MCP.

3. أضف خادم ملفات MCP:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. احفظ وأعد تشغيل Cursor.

5. تحقق من التكامل بتشغيل أداة اختبار (مثل list_directory).

Cline

1. قم ببناء أو تحميل ملف خادم ملفات MCP.

2. عدّل إعدادات تكامل MCP في Cline.

3. أضف:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. احفظ الإعدادات وأعد تشغيل Cline.

5. اختبر عبر تنفيذ عملية read_file.

ملاحظة حول تأمين مفاتيح API

استخدم متغيرات البيئة للبيانات الحساسة. مثال:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

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

استخدام MCP في فلوهانت

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

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

{
  "filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع جميع وظائفه وقدراته. تذكّر تغيير “filesystem” إلى اسم خادم MCP الفعلي الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

| دعم الجذور | ✅ | أداة list_allowed_directories تعرض الجذور المسموح بها |

رأينا

يعد خادم ملفات MCP قويًا ويركز بشكل كبير على الوصول الآمن والدقيق لنظام الملفات—مقدمًا مجموعة شاملة من عمليات الملفات والمجلدات كأدوات MCP. توثيقه واضح، ويوفر العديد من الأدوات العملية لسير عمل التطوير المدعوم بالذكاء الاصطناعي. لكنه لا يذكر قوالب مطالبات أو موارد MCP صريحة، كما أن ميزات مثل دعم العينات غير مذكورة. الجذور مدعومة عبر أداة list_allowed_directories.

التقييم: 8/10 — أدوات وتوثيق ممتازان، مع بعض الثغرات الطفيفة في ميزات المطالبات/الموارد والميزات المتقدمة لـ MCP.

تقييم MCP