أدوات MCP

كل الأدوات الـ 17 التي يعطيها خادم GoBanana لوكيلك، مجمعة حسب المهمة، مع الخطة والحصة وما تغيره كل أداة. المرجع الرسمي - banana-server/lib/mcp/tools.

يسجل خادم GoBanana MCP على https://gobanana.fun/api/mcp هذه الأدوات. نقطة الاتصال تتطلب تسجيل الدخول في كل استدعاء، لذلك تعمل كل أداة باسم حسابك.

حسب المهمة

الأداة	ما تفعله	الخطة	تستهلك عملية بحث	تغير البيانات
`ping`	تفحص الاتصال وتعرض بريدك الإلكتروني	الكل	لا	لا
`get_playbook`	تعيد دليل تشغيل GoBanana لمهارة أو خطوة أو أداة مساعدة بالاسم (`gobanana-explore`، `gobanana-explore/intake`). تستدعيها مهارات الإضافة أولا	الكل	لا	لا
الثني والحكم
`bend_brief`	تحول الموجز إلى اتجاهات جامحة مع مواصفات بصرية، أو تعيد مواضع الجنون	الكل، بلا حد	لا	تحفظ الاتجاهات مع `canvasId`
`rate_directions`	تبقي الاتجاهات على اللوحة أو تستبعدها	الكل	لا	نعم
البحث والحكم
`search_references`	تجد مراجع الواجهات والاتجاه الفني لاتجاه ما أو لاستعلام	الكل	نعم، 1 لكل استدعاء	تملأ الدرج مع `canvasId`
`rate_references`	تقيّم النتائج بـ great أو bad، والسيئة تخرج ولا تعود أبدا	الكل	لا	نعم
اللوحات
`new_canvas`	تنشئ لوحة دون عرضها	الكل (المجانية: 3 لوحات)	لا	نعم
`open_canvas`	تعرض لوحة داخل المحادثة، أو تنشئ واحدة وتعرضها	الكل	لا	تنشئ لوحة إذا لم يُمرر `canvasId`
`get_canvas`	تقرأ لوحة، أو تسرد آخر 10 لوحات لك	الكل	لا	لا
`get_snapshot`	تعرض للوكيل قسما أو صفحة فرانكنشتاين كصور مصغرة، جزءا جزءا	الكل	لا	لا
`add_to_canvas`	تضع المراجع وشاشات Mobbin والملاحظات وعينات الألوان والأقسام	الكل (المجانية: 40 عنصرا)	لا	نعم
`arrange_canvas`	ترتب اللوحة أو قسما واحدا منها	الكل	لا	نعم
`delete_canvas`	تحذف اللوحة نهائيا، مع `confirm: true`	الكل	لا	نعم، حذف نهائي
Frankenstein it
`cut_parts`	تقص أجزاء (مستطيلات قص) إلى مكتبة الأجزاء	الكل	لا	نعم
`frankenstein_page`	تكدس الأجزاء في نسخ صفحات جديدة	الكل	لا	نعم
`remix_frankenstein`	تصنع نسخا من صفحة مع قفل	الكل	لا	نعم
`update_frankenstein`	تغير صفحة واحدة بعمليات	الكل	لا	نعم
الألوان والملفات
`extract_palette`	ألوان مع أدوارها وتباين WCAG	الكل	لا	تحفظ لوحة الألوان، وعينات الألوان مع `addSwatches`
`export_kit`	تعيد ملفات: DIRECTION.md، BUILD-PROMPT.md، قواعد…	المجانية: 5 صيغ، Pro: كل الصيغ الـ 15	لا	لا

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

قواعد مشتركة

المدخلات تُفحص ولا تُرمى أخطاء. كل أداة تعلن مخطط JSON صارما، لكنها ترد على المدخلات الخاطئة بجملة واحدة بسيطة، مثل “brief must be 1 to 500 characters.”. اقرأ content[0].text.
نص مع بنية. كل إجابة فيها نص مقروء للوكيل (content) والبيانات نفسها في structuredContent للتطبيقات.
المعرّفات. معرّفات اللوحات والاتجاهات والمراجع والعناصر من 1 إلى 100 حرف من الحروف والأرقام و_ و-. معرّفات الاتجاهات من bend_brief تشبه bd-z0y2y96z، ومعرّفات المراجع تشبه ref_...، ومعرّفات الأجزاء pt-...، ومعرّفات صفحات فرانكنشتاين st-....
طلبات الإزالة تُفحص عند كل تحميل للوحة وكل عملية بحث. الروابط المحجوبة تختفي في كل مكان، بما في ذلك روابط المشاركة.
روابط المصادر. نص الأدوات يذكّر الوكيل باستمرار: اعرض دائما رابط المصدر لكل مرجع.
رسائل شائعة: “You are not signed in. Reconnect to sign in again.”، “That canvas was not found. Call open_canvas to create one, or check the canvasId.”، “The canvas changed while saving. Try again.”، “Something went wrong on our side. Try again in a minute.”

الترتيب المعتاد

get_canvas (list) → new_canvas → bend_brief (count 8, canvasId)
→ search_references (per kept direction) → rate_references → rate_directions
→ add_to_canvas → arrange_canvas → open_canvas
→ cut_parts → frankenstein_page → update_frankenstein / remix_frankenstein
→ extract_palette → export_kit