إعداد Cursor MCP لبطاقات المراجعة: خطوة بخطوة

إذا كنت تستخدم Cursor كمحررك الأساسي، فيمكنك ربطه بـ Deckbase(opens in a new tab) عبر بروتوكول سياق النموذج (MCP) وإنشاء بطاقات مراجعة مباشرة من قاعدة شيفرتك، دون التنقل بين التطبيقات ولا نسخ المحتوى ولا مغادرة محررك.

يشرح هذا الدليل إعداد Cursor MCP الكامل لإنشاء بطاقات المراجعة: ما هو MCP، وما يمكنك فعله مع تكامل Deckbase، وخطوات الإعداد المتتابعة.

ما هو MCP ولماذا يهم في بطاقات المراجعة؟

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

وبالنسبة لإنشاء بطاقات المراجعة، يعني ذلك أنك تستطيع:

• تحديد دالة أو صنف أو مقطع من التوثيق وتطلب من Cursor إنشاء بطاقات مراجعة منه

• توليد بطاقات من تعليقات الشيفرة أو ملفات README أو التوثيق المضمّن

• بناء مجموعة بطاقات من أي ملف أو مجلد في مشروعك

• إضافة بطاقات إلى مجموعة موجودة في Deckbase دون مغادرة المحرر

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

المتطلبات الأساسية

• Cursor (أحدث إصدار)

• حساب Deckbase(opens in a new tab) (الخطة المجانية كافية)

• مفتاح API من Deckbase (متاح في إعدادات الحساب)

• Node.js 18 أو أحدث مثبتًا (لتشغيل خادم MCP)

الخطوة 1: احصل على مفتاح API الخاص بـ Deckbase

1. سجّل الدخول إلى deckbase.co(opens in a new tab)

2. انتقل إلى الإعدادات → API

3. أنشئ مفتاح API جديدًا

4. انسخ المفتاح: ستحتاجه في الخطوة التالية

الخطوة 2: أضف خادم Deckbase MCP إلى Cursor

افتح إعدادات Cursor → الميزات → خوادم MCP. ثم أضف إعداد خادم جديدًا:

{
  "name": "deckbase",
  "command": "npx",
  "args": ["-y", "@deckbase/mcp-server"],
  "env": {
    "DECKBASE_API_KEY": "your-api-key-here"
  }
}

احفظ الإعدادات وأعد تشغيل Cursor. سيبدأ خادم Deckbase MCP تلقائيًا عند تشغيل Cursor.

→ التوثيق الكامل لخادم MCP(opens in a new tab)

الخطوة 3: تحقق من الاتصال

افتح محادثة جديدة في Cursor واكتب:

استخدم أداة Deckbase MCP لعرض قائمة مجموعاتي.

إذا كان الاتصال يعمل، سيعرض Cursor قائمة بمجموعاتك في Deckbase. وإذا ظهرت لك رسالة خطأ، فتأكد من صحة مفتاح API ومن أن خادم MCP بدأ دون أخطاء (راجع سجلات خادم MCP في إعدادات Cursor).

الخطوة 4: أنشئ أول بطاقاتك من ملف شيفرة

حدد دالة أو صنفًا في محررك، وافتح محادثة في Cursor، ثم جرّب:

أنشئ 5 بطاقات مراجعة من هذه الشيفرة أستطيع استخدامها لمراجعة طريقة عمل هذه الدالة. وأضفها إلى مجموعة «Python internals».

سيستخدم Cursor أداة Deckbase MCP لتوليد البطاقات وإضافتها مباشرة. بلا نسخ ولصق، وبلا تنقل بين التبويبات.

ما يمكنك إنشاء بطاقات منه

يعمل تكامل Deckbase MCP مع أي نص يستطيع Cursor الوصول إليه:

• ملفات الشيفرة: الدوال والأصناف والخوارزميات وأنماط التصميم

• التوثيق: ملفات README ومراجع API والتوثيق المضمّن

• التعليقات: تعليقات TODO وملاحظات البنية والشرح المضمّن

• ملفات الإعدادات: فهم وظيفة كل خيار

• ملفات الاختبار: فهم السلوك الذي يجري التحقق منه

أمثلة على الأوامر لإنشاء بطاقات مراجعة تقنية

لقاعدة شيفرة جديدة:

أنا أتعلم قاعدة الشيفرة هذه. أنشئ 10 بطاقات مراجعة من وحدة المصادقة تساعدني على فهم طريقة عمل إدارة الجلسات. وأضفها إلى مجموعة «Codebase onboarding».

للتحضير للامتحانات:

ولّد 15 بطاقة مراجعة من هذا القسم من توثيق AWS IAM الذي يغطي الفروق بين الأدوار والسياسات وحدود الأذونات. وأضفها إلى مجموعة «AWS Solutions Architect».

للمراجعة اليومية من العمل:

خذ آخر 3 دوال كتبتها اليوم وأنشئ لكل واحدة بطاقات مراجعة تغطي المنطق الأساسي والحالات الحدية التي تعاملت معها وسبب اختياري لهذا الأسلوب. وأضفها إلى مجموعة «Work knowledge base».

مراجعة البطاقات في Deckbase

تظهر البطاقات التي تنشئها عبر Cursor MCP فورًا في مجموعتك في Deckbase، جاهزة للمراجعة وفق جدولة FSRS. افتح تطبيق Deckbase على الويب(opens in a new tab) أو تطبيق الهاتف لمراجعتها وفق جدولك المعتاد.

والجمع بين Cursor للإنشاء وDeckbase للمراجعة يكوّن حلقة مغلقة: تتعلم من شيفرة حقيقية، وتراجع المفاهيم بجدولة تكيفية، وتحتفظ بمعرفة تقنية كانت ستتلاشى بين المشاريع.

→ أمثلة على أتمتة الدراسة عبر MCP(opens in a new tab)

الأسئلة الشائعة: Cursor MCP لبطاقات المراجعة

هل يعمل Deckbase MCP مع محررات أخرى غير Cursor؟

نعم. خادم Deckbase MCP متوافق مع أي عميل يدعم MCP. ويمكن لـ Claude Desktop وCline وContinue وغيرها من الأدوات الداعمة لـ MCP استخدام إعداد الخادم نفسه.

هل أحتاج إلى خطة مدفوعة في Deckbase للوصول إلى MCP؟

راجع تفاصيل الخطة الحالية على deckbase.co/mcp(opens in a new tab). تدعم الخطة المجانية اتصالات MCP لعمليات المجموعات الأساسية.

هل يمكنني إنشاء بطاقات من شيفرة خاصة دون أن تخرج من جهازي؟

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

ماذا لو لم تكن مجموعتي موجودة بعد عندما أطلب من Cursor إضافة بطاقات؟

تستطيع أداة Deckbase MCP إنشاء مجموعات جديدة ضمن مسار إنشاء البطاقات. اطلب من Cursor: «أنشئ مجموعة جديدة باسم X وأضف هذه البطاقات».

ما الفرق بين هذا وبين نسخ النص يدويًا إلى Deckbase؟

الفوائد الأساسية هي: عدم التنقل بين التطبيقات، والاستغناء عن خطوة النسخ واللصق، والقدرة على إنشاء بطاقات من أي ملف في مشروعك دون فتح متصفح. وبالنسبة للمتعلمين الذين يقضون معظم وقت دراستهم في محرر شيفرة، فإن تقليص خطوات سير العمل ميزة كبيرة.

→ إعداد خادم Deckbase MCP(opens in a new tab)

→ نظرة عامة على بطاقات المراجعة بالذكاء الاصطناعي في Deckbase(opens in a new tab)