خادم Nocodb MCP

ماذا يفعل خادم “Nocodb” MCP؟

يعمل خادم Nocodb MCP كجسر بين المساعدين الذكيين وقواعد بيانات Nocodb باستخدام بروتوكول Model Context (MCP). يتيح هذا الخادم للعملاء المدعومين بالذكاء الاصطناعي تنفيذ عمليات CRUD (إنشاء، قراءة، تحديث، حذف) بسلاسة على جداول Nocodb، مما يسهل سير عمل إدارة البيانات. من خلال إتاحة وظائف قاعدة البيانات عبر واجهة MCP، يصبح بإمكان نماذج اللغة الكبيرة ووكلاء الذكاء الاصطناعي الاستعلام، وإنشاء، وتحديث، وحذف السجلات أو الأعمدة، بل ورفع ملفات لإنشاء جداول جديدة. يعزز هذا التكامل إنتاجية المطورين من خلال أتمتة وتوحيد عمليات التفاعل مع قاعدة البيانات، مما يجعل بناء واختبار ونشر تطبيقات وسير عمل الذكاء الاصطناعي المعتمدة على قواعد البيانات أسهل بكثير.

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

• الحصول على السجلات: استرجاع البيانات من جدول Nocodb محدد.
• إنشاء سجل: إضافة صفوف جديدة بقيم محددة إلى جدول.
• تحديث سجل: تحديث السجلات الحالية، مثل تعديل القيم أو إزالة اللواحق.
• حذف سجل: إزالة السجلات بناءً على معايير مثل مطابقة الأسماء.
• إضافة عمود: إضافة أعمدة جديدة إلى جدول موجود.
• تحديث قيم الأعمدة: تعيين قيم الأعمدة لجميع الصفوف.
• حذف عمود: إزالة الأعمدة من جدول.
• إنشاء جدول من ملف: إنشاء جدول جديد باستخدام بيانات من ملف JSON.
• إنشاء سجلات جماعياً: إضافة عدة سجلات جديدة في عملية واحدة.
• حذف سجلات جماعياً: إزالة عدة سجلات دفعة واحدة.

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

• جداول Nocodb: الوصول إلى جميع الجداول ضمن قاعدة بيانات Nocodb المتصلة، مما يسمح بقراءة البيانات واستخدامها كسياق.
• مخطط الجدول: بيانات وصفية حول بنية كل جدول مثل أسماء الأعمدة وأنواع البيانات.
• الملفات المرفوعة: ملفات JSON (مثل example_upload.json) يمكن معالجتها لإنشاء أو تحديث الجداول.
• بيانات عينة جماعية: بيانات تجريبية جماعية ولقطات شاشة متوفرة في مجلد docs/sample-bulk لأغراض العرض والسياق.

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

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

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

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

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

Windsurf

1. تأكد من تثبيت المتطلبات الأساسية مثل Node.js وNocodb.
2. حدد موقع ملف إعدادات Windsurf (مثال: settings.json).
3. أضف خادم Nocodb MCP باستخدام مقطع JSON التالي:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. احفظ الإعدادات وأعد تشغيل Windsurf.
5. تحقق من تشغيل الخادم وإمكانية الوصول إليه عبر اختبار عملية قاعدة بيانات تجريبية.

Claude

1. ثبت Node.js وتأكد من الوصول إلى مثيل Nocodb.
2. عدل ملف إعدادات MCP لمنصة Claude.
3. أضف الخادم كما يلي:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. أعد تشغيل Claude وتحقق من الاتصال بالخادم.
5. أكد ذلك عبر تنفيذ قالب طلب تجريبي.

Cursor

1. حضر بيئة العمل لديك مع Node.js وبيانات اعتماد Nocodb.
2. افتح إعدادات Cursor أو لوحة تكامل MCP.
3. أدخل التكوين التالي:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. احفظ وأعد تشغيل Cursor.
5. تحقق من الخادم عن طريق تنفيذ عملية CRUD.

Cline

1. ثبت Node.js وتأكد من توفر Nocodb.
2. عدل إعدادات Cline الخاصة بخوادم MCP.
3. أضف الخادم كما يلي:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. احفظ التغييرات وأعد تشغيل Cline.
5. اختبر الإعداد عبر الاتصال بجدول Nocodb.

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

قم بتخزين مفاتيح API في متغيرات البيئة للأمان. مثال:

{
  "env": {
    "NOCODB_API_KEY": "your-nocodb-key"
  },
  "inputs": {
    "api_key": "${NOCODB_API_KEY}"
  }
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

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

تقييم MCP