خادم ArangoDB MCP

ما الذي يقدمه خادم “ArangoDB” MCP؟

خادم ArangoDB MCP هو خادم بروتوكول سياق النموذج (MCP) مبني بلغة TypeScript يوفر إمكانيات تفاعل سلسة مع قاعدة بيانات ArangoDB. يعمل كجسر قوي بين مساعدين الذكاء الاصطناعي وقاعدة بيانات ArangoDB، حيث يمكّن المطورين والوكلاء المدعومين بنماذج اللغة الكبيرة من تنفيذ العمليات الأساسية مباشرة عبر أدوات MCP الموحدة. يتيح هذا الخادم مهام مثل الاستعلام عن البيانات، إدراج وتحديث الوثائق، إدارة الجداول، وتنفيذ النسخ الاحتياطية، وذلك من خلال استدعاءات أدوات بسيطة. كما أن تكامله مع منصات مثل Claude وVSCode (عبر إضافات مثل Cline) وغيرها يجعله قاعدة خلفية متعددة الاستخدامات لتعزيز سير العمل التطويري الذي يتطلب وصولاً برمجياً أو فورياً للبيانات المهيكلة.

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

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

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

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

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

• arango_query
  تنفيذ استعلامات AQL (لغة استعلام ArangoDB). يأخذ سلسلة استعلام ومتغيرات ربط اختيارية، ويعيد النتائج بتنسيق JSON.

• arango_insert
  إدراج وثائق في الجداول. يتطلب اسم الجدول وكائن الوثيقة؛ يتم إنشاء مفتاح الوثيقة تلقائياً إذا لم يُقدم.

• arango_update
  تحديث وثائق موجودة في جدول. يتطلب اسم الجدول، مفتاح الوثيقة، وكائن التحديث.

• arango_remove
  حذف وثائق من الجداول. يتطلب اسم الجدول ومفتاح الوثيقة.

• arango_backup
  نسخ جميع الجداول احتياطيًا إلى ملفات JSON في مجلد محدد، مناسب لترحيل البيانات والنسخ الاحتياطي.

• arango_list_collections
  عرض جميع الجداول في قاعدة البيانات مع إرجاع الأسماء والمعرفات والأنواع.

• arango_create_collection
  إنشاء جدول جديد (نوع وثيقة أو حافة) مع خيارات للاسم والنوع وسلوك المزامنة.

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

• إدارة قواعد البيانات
  تنفيذ عمليات CRUD (إنشاء، قراءة، تحديث، حذف) بسهولة على جداول ArangoDB مباشرة من أدوات أو وكلاء الذكاء الاصطناعي.

• استكشاف قاعدة الشيفرة للمشاريع المعتمدة على البيانات
  تمكين المطورين من الاستعلام وتعديل بيانات التطبيقات دون مغادرة بيئة التطوير، لتسهيل استكشاف البيانات.

• النسخ الاحتياطي والترحيل التلقائي للبيانات
  استخدم أداة النسخ الاحتياطي لتصدير بيانات الجداول بتنسيق JSON، مما يدعم سير عمل النسخ الاحتياطي التلقائي ويسهل عمليات الترحيل.

• التكامل مع وكلاء الذكاء الاصطناعي
  تمكين LLMs ومساعدي الذكاء الاصطناعي (مثل Claude أو الموجودين في VSCode عبر Cline) من جلب أو تحديث أو تحليل بيانات القاعدة كجزء من سير عمل الوكلاء.

• إدارة الجداول الديناميكية
  السماح بإنشاء الجداول وعرضها برمجيًا، لدعم النماذج الأولية السريعة أو تطبيقات تعدد المستأجرين.

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

Windsurf

لم يتم توفير تعليمات إعداد لـ Windsurf.

Claude

لم يتم توفير تعليمات إعداد لـ Claude.

Cursor

لم يتم توفير تعليمات إعداد لـ Cursor.

Cline (إضافة VSCode)

1. المتطلبات الأساسية: تأكد من تثبيت VSCode (الإصدار 1.99.0 أو أحدث).
2. تحرير/إنشاء إعدادات MCP:
   • مساحة العمل: .vscode/mcp.json
   • المستخدم: أضفها لإعدادات مستخدم VSCode للاستخدام على مستوى النظام.
3. أضف تكوين خادم ArangoDB MCP:

   {
     "servers": {
       "arango-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": ["arango-server"],
         "env": {
           "ARANGO_URL": "http://localhost:8529",
           "ARANGO_DB": "v20",
           "ARANGO_USERNAME": "app",
           "ARANGO_PASSWORD": "75Sab@MYa3Dj8Fc"
         }
       }
     }
   }
   

4. تشغيل خادم MCP:
   • افتح لوحة الأوامر (Ctrl+Shift+P أو Cmd+Shift+P على الماك)
   • شغل MCP: Start Server واختر arango-mcp.

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

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

{
  "servers": {
    "arango-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["arango-server"],
      "env": {
        "ARANGO_URL": "${env:ARANGO_URL}",
        "ARANGO_DB": "${env:ARANGO_DB}",
        "ARANGO_USERNAME": "${env:ARANGO_USERNAME}",
        "ARANGO_PASSWORD": "${env:ARANGO_PASSWORD}"
      }
    }
  }
}

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

استخدام MCP في FlowHunt

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

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

{
  "arango-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

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

نظرة عامة

رأينا

هذا الخادم MCP موثق بشكل جيد من حيث دعم الأدوات والإعداد، وخاصة لـ VSCode/Cline. ومع ذلك، يفتقر إلى قوالب أوامر وموارد واضحة، ولا يوجد ذكر لدعم العينة أو الجذور. قوته الرئيسية في مجموعة الأدوات الشاملة وإدارة متغيرات البيئة بوضوح.
بشكل عام، نقيم هذا الخادم MCP بدرجة 7/10 من حيث الفائدة العملية والتوثيق، مع غياب بعض ميزات MCP المتقدمة.

تقييم MCP