mcpignore-filesystem خادم MCP

ماذا يفعل خادم “mcpignore-filesystem” MCP؟

يعد خادم mcpignore-filesystem MCP أداة مبنية على Node.js تعزز سير عمل تطوير مساعدي الذكاء الاصطناعي من خلال توفير تحكم آمن ودقيق في الوصول إلى نظام الملفات. استنادًا إلى خادم Filesystem MCP القياسي، يقدم هذا الخادم دعمًا لملفات .mcpignore، مما يمكّنك من تقييد الملفات والمجلدات التي يمكن لعملاء MCP (مثل وكلاء الذكاء الاصطناعي) التفاعل معها. من خلال تحديد أنماط التجاهل المشابهة لـ .gitignore، يمكنك حماية البيانات الحساسة وضمان أن الملفات المصرح بها فقط متاحة لعمليات مثل القراءة والكتابة وإدارة المجلدات والبحث. يمكّن هذا الخادم المهام التطويرية المتعلقة بإدارة الملفات مع الحفاظ على أمان البيانات والضوابط الصارمة للوصول، مما يجعله مثاليًا للفرق التي تحتاج إلى واجهات نظام ملفات قوية وقابلة للتخصيص لسير عمل مدفوع بالذكاء الاصطناعي.

قائمة المحفزات

لا توجد قوالب محفزات مذكورة في المستودع.

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

لا توجد موارد MCP صريحة موثقة في المستودع.

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

• read_file: يقرأ ملفًا ما لم يتطابق مع نمط .mcpignore (محظور للمسارات المتجاهلة).
• read_multiple_files: يقرأ عدة ملفات ما لم تكن متجاهلة (محظور للمسارات المتجاهلة).
• write_file: يكتب إلى ملف ما لم يكن متجاهلاً (محظور للمسارات المتجاهلة).
• edit_file: يحرر ملفًا ما لم يكن متجاهلاً (محظور للمسارات المتجاهلة).
• create_directory: ينشئ مجلدًا ما لم يكن متجاهلاً (محظور للمسارات المتجاهلة).
• list_directory: يعرض محتويات المجلد ما لم يكن متجاهلاً (محظور للمسارات المتجاهلة).
• move_file: ينقل ملفات أو مجلدات ما لم تكن متجاهلة (محظور للمسارات المتجاهلة).
• get_file_info: يسترجع بيانات وصفية للملف ما لم يكن متجاهلاً (محظور للمسارات المتجاهلة).
• directory_tree: يسترجع بنية المجلدات (مسموح به، يعرض الأسماء فقط).
• search_files: يبحث عن ملفات (مسموح به، يعرض الأسماء فقط).
• list_allowed_directories: يعرض المجلدات المسموح بالوصول إليها (غير متوفر لمنطق التجاهل).

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

• أمان دقيق لنظام الملفات: يمكن للمطورين منح وكلاء الذكاء الاصطناعي وصولاً محكومًا إلى مجلدات المشاريع، مع حماية الملفات الحساسة (مثل .env، الأسرار، بيانات الاعتماد) عبر تحديدها في .mcpignore.
• استكشاف آمن لقاعدة الشيفرة: يمكن لأدوات الذكاء الاصطناعي تحليل واستكشاف قواعد شيفرة كبيرة مع ضمان استبعاد الملفات السرية أو الملكية من التعرض.
• إدارة ملفات مؤتمتة: أتمتة المهام الروتينية مثل التنظيم أو البحث أو نقل الملفات عبر المجلدات، مع قيود وصول صارمة عبر .mcpignore.
• بيئات تطوير تعاونية: مشاركة مجلدات آمنة مع مساعدي الذكاء الاصطناعي للتحرير أو البحث مع حظر الوصول للملفات الداخلية أو المؤقتة.
• الامتثال والتدقيق: فرض الامتثال للبيانات من خلال التأكد من عدم إمكانية وصول الأدوات المؤتمتة إلى أنواع أو ملفات بيانات معينة، مما يساعد في التدقيق والحوكمة.

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

Windsurf

لا توجد تعليمات خاصة بـ Windsurf مذكورة في المستودع.

Claude

1. تأكد من تثبيت Node.js و npx.
2. افتح ملف claude_desktop_config.json الخاص بك.
3. أضف إعدادات الخادم MCP كما هو موضح أدناه.
4. احفظ الملف وأعد تشغيل Claude.
5. تحقق من أن الخادم يعمل وقابل للوصول.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

تأمين مفاتيح API (مثال):

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [ ... ],
      "env": {
        "API_KEY": "${MCP_SERVER_API_KEY}"
      },
      "inputs": {
        "api_key": "${MCP_SERVER_API_KEY}"
      }
    }
  }
}

Cursor

1. تأكد من تثبيت Node.js و npx.
2. افتح ملف الإعدادات mcp.json.
3. أضف إعدادات الخادم كما يلي.
4. احفظ الملف وأعد تشغيل Cursor.
5. تحقق من الاتصال بالخادم.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

تأمين مفاتيح API: (انظر مثال Claude أعلاه)

Cline

1. تأكد من تثبيت Node.js و npx.
2. افتح ملف cline_mcp_settings.json.
3. أضف إعدادات الخادم.
4. احفظ وأعد تشغيل Cline.
5. تحقق من توفر الخادم.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

تأمين مفاتيح API: (انظر مثال Claude أعلاه)

Windsurf

لا توجد تعليمات إعداد متوفرة.

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

استنادًا إلى المعلومات المتوفرة، يقدم هذا الخادم MCP أدوات قوية ومُوثقة بوضوح لنظام الملفات مع مزايا أمان قوية، لكنه يفتقر إلى قوالب المحفزات وقوالب الموارد. لا يوجد أيضًا ذكر صريح لـ Roots أو دعم العينات. لذا فهو خيار قوي لإدارة الملفات الآمنة، لكنه قد لا يكون مناسبًا لسير العمل الذي يتطلب قوالب محفزات أو معالجة موارد متقدمة.

تقييم MCP

التقييم:
أقيّم هذا الخادم MCP بـ 6/10. يتميز بتركيز واضح على الأمان، وتوثيق للأدوات، والامتثال للترخيص، لكنه يفتقر إلى قوالب المحفزات، وتعريفات الموارد، وأدلة على دعم الجذور أو العينات. تكمن قيمته الأساسية للفرق التي تبحث عن وصول آمن ومبني على التجاهل إلى نظام الملفات لوكلاء الذكاء الاصطناعي.