Google تطلق colab-mcp: كيف تقوم الوكلاء بأتمتة دفاتر Colab في الإنتاج

أصدرت Google خادم colab-mcp مفتوح المصدر الذي يسمح لوكلاء الذكاء الاصطناعي بإدارة دفاتر Google Colab عبر MCP وتنفيذ الكود في وقت التشغيل دون عمل يدوي في الواجهة.

كيفية عمل colab-mcp

colab-mcp هو خادم MCP لـ Google Colab يحول دفتر المتصفح إلى بيئة عمل قابلة للبرمجة. يمكن للوكيل ليس فقط قراءة هيكل الدفتر، بل أيضاً إضافة خلايا وتشغيل الكود والحصول على النتائج مجددة كاستدعاءات أدوات عادية. يوضح التحليل كيف يتم تجميع هذا المخطط من سجل أدوات أساسي إلى خادم FastMCP كامل، حتى يفهم المطورون ليس فقط واجهة برمجية التطبيقات بل الآليات الداخلية لتسجيل الأدوات وJSON Schema والتوزيع غير المتزامن.

يبدأ المؤلفون بسجل MCPToolRegistry الأدنى المبني يدويًا في Python. يوضح هذا المثال كيف تصبح الدالة أداة وكيف تبني تلميحات النوع مخطط المعاملات وكيف يستدعي العميل أداة بالاسم مع الحجج. هذا النهج مفيد خارج Colab: فهو يشرح نموذج MCP الأساسي بدون سحر الإطار ويساعد في فهم ما يفعله FastMCP تحت الغطاء عندما يُعطى الوكلاء قائمة الإجراءات المتاحة.

يتم التركيز الخاص على البنية الثنائية الأوضاع لـ Google. في وضع Session Proxy Mode، يعمل الوكيل عبر جسر WebSocket بين عميل MCP محلي و Colab المفتوح في المتصفح. في Runtime Mode، ينتقل مباشرة إلى النواة وينفذ كود Python دون إجراءات بصرية في الواجهة.

هذا الفصل مهم: الوضع الأول مناسب للعمل التفاعلي مع الدفاتر، والثاني لسيناريوهات headless حيث يكون التنفيذ المباشر للحسابات والتنفيذ المستقر للكود على جانب runtime ضروريين.

خمس خطوات نحو وكيل

تنقسم الجزء العملي إلى خمس كتل مستقلة تؤدي من العرض التوضيحي إلى أنماط الإنتاج. أولاً، يقوم المؤلف بتجميع سجل MCP الأدنى يدويًا وتسجيل أدوات مثل execute_code وadd_code_cell وadd_text_cell وget_cells. ثم يتم نقل نفس النهج إلى FastMCP، حيث يتم تشغيل خادم أكثر واقعية مع مجموعة من أدوات proxy و runtime.

يوفر هذا ليس بنية مجردة بل مساراً متسلسلاً: فهم البروتوكول أولاً، ثم استبدال المكونات محلية الصنع بالبنية التحتية الوظيفية. بعد ذلك، يوضح البرنامج التعليمي كيف تبدو الاتصال الحي بين وكيل و Colab. في المثال، يتم تشغيل خادم WebSocket آمن برمز، ويتم محاكاة اتصال عميل المتصفح والتحقق من استدعاءات JSON-RPC بين الواجهة الأمامية وعميل MCP.

بعد ذلك، يتم بناء محرك runtime مع حالة دائمة وتهيئة كسولة ومعالجة الإخراج بأسلوب Jupyter. أي أن الوكيل لا يرى مجرد حقيقة تنفيذ الكود بل نتيجة منظمة وأخطاء وبيانات وسيطة يمكن استخدامها للمتابعة مع الخطوة التالية. المستوى التالي هو حلقة وكيل كاملة.

يتلقى مهمة باللغة الطبيعية، ويختار الأداة الصحيحة، وينفذ الكود، ويحلل النتيجة، وإذا لزم الأمر، يتخذ خطوة أخرى. هذا هو بالضبط النمط المستخدم في التكاملات الحقيقية مع Claude Code و Gemini CLI، وفقاً للمؤلفين. نتيجة لذلك، يصبح Colab ليس علامة تبويب منفصلة للعمل اليدوي بل واجهة خلفية حسابية يمكن لـ LLM إدارتها كجزء من سير عمل عام.

• سجل MCP الأساسي وإنشاء المخطط
• الانتقال إلى FastMCP وخادم أكثر واقعية
• Session Proxy Mode مع WebSocket والرمز و JSON-RPC
• Runtime Mode مع تنفيذ مباشر للكود وحالة النواة
• حلقة وكيل كاملة مع اختيار الأدوات وتحليل النتائج

الموثوقية والإطلاق

الجزء الأكثر عملية هو تنسيق الإنتاج على runtime. توضح المقالة RobustNotebookOrchestrator، الذي يضيف محاولات تلقائية مع exponential backoff وأوقات انتظار عبر asyncio.wait_for والتنفيذ التابع للخلايا.

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

ثم يصدر النظام تقريراً منظماً لكل خلية مع الحالة والمدة وعدد المحاولات. هذا ليس مستوى العروض التوضيحية البسيطة بل قالب للسيناريوهات البحثية والهندسية الحقيقية حيث تكون الملاحظة والتحكم في الأخطاء والقابلية للتنبؤ بالتنفيذ مهمة. يوضح المؤلف أيضاً مساراً سريعاً للإطلاق بدون تكامل كبير: تثبيت uv وإضافة colab-mcp إلى config MCP وفتح Colab في المتصفح وإعطاء الوكيل أمراً باللغة الطبيعية مثل بناء دفتر لتحليل البيانات.

يتم دعم العملاء المحليين الشهيرين مثل Claude Code و Gemini CLI و Windsurf، وللوكلاء المخصصين يتم عرض قالب للاتصال عبر واجهة برمجية التطبيقات مع وصف الأدوات وحلقة معالجة tool_use. يقلل هذا من حاجز الدخول: أولاً يمكنك توصيل عميل جاهز ثم كتابة غلاف وكيل خاص بك.

ما يعنيه هذا

يحرك colab-mcp Google Colab من وضع الدفتر اليدوي نحو بيئة قابلة للبرمجة للوكلاء ذوي الذكاء الاصطناعي. بالنسبة للمطورين، هذا مسار مباشر لأتمتة تحليل البيانات والتجارب وتدريب النماذج دون كتابة أتمتة واجهة مستخدم منفصلة وبدون التبديل المستمر بين الدردشة والكود والمتصفح. إذا ترسخت الأداة في نظام MCP البيئي، فقد تصبح Colab واحدة من أكثر الواجهات الخلفية الحسابية ملاءمة لسيناريوهات الوكلاء.