كيف يمكنني إضافة أدوات أو ملحقات مخصصة إلى Gemini CLI

تمديد Gemini CLI مع أدوات مخصصة عبر MCP

تم تصميم Gemini CLI ليكون قابلاً للتوسعة من خلال بروتوكول سياق النموذج (MCP). يعمل MCP كوسيلة موحدة لتوصيل الخدمات والقدرات الخارجية (الأدوات) إلى Gemini CLI. من خلال تكوين خوادم MCP ، يمكن لـ Gemini CLI دمج هذه الأدوات الخارجية بسلاسة في عملها وسير العمل المنطقي.

- إعداد خوادم MCP:
يمكنك البدء بتكوين خوادم MCP في ملف إعدادات Gemini CLI ، والذي يوجد عادة في `~/.gemini/settings.json`. يقوم ملف JSON هذا بتكوين خوادم MCP التي تتصل بها ، بما في ذلك تفاصيل الاتصال والمصادقة إذا لزم الأمر.

- استخدام خوادم MCP الحالية أو المخصصة:
تتفاعل العديد من خوادم MCP الحالية مع خدمات شائعة مثل GitHub أو GitLab أو Firebase أو قواعد البيانات أو توليد الوسائط. للحصول على وظائف مخصصة حقًا ، يمكنك إنشاء خوادم MCP الخاصة بك باستخدام MCP SDK المتوفرة بلغات مثل Python أو TypeScript. يسمح هذا باستضافة أي منطق أو أداة مخصصة كخادم MCP.

- تكوين خوادم MCP:
في ملف `settings.json` ، يتم تعريف خوادم MCP بأسمائها أو أنواع الخادم أو أوامر الاتصال أو عناوين URL ، الرموز المميزة للمصادقة ، وأي معلمات متخصصة. بمجرد تكوينه ، سيتصل Gemini CLI بهذه الخوادم عند بدء التشغيل.

- اكتشاف الأدوات واستخدامها:
بعد الاتصال ، تعرض خوادم MCP الأدوات التي يكتشفها Gemini CLI تلقائيًا. يمكنك إدراج هذه الأدوات ووصفها بأوامر مثل `/mcp` و`/mcp desc`. ثم يقوم وكيل الذكاء الاصطناعى بدمجهم أصليًا في اتخاذ القرارات وتدفق التنفيذ ، واختيار الأدوات حسب الحاجة بناءً على مطالبات المستخدم دون تدخل يدوي.

إنشاء ملحقات Gemini CLI

إلى جانب خوادم MCP ، يدعم Gemini CLI مفهومًا أعلى مستوى يسمى الامتدادات ، والذي يجمع بين خوادم MCP وملفات السياق والأوامر المخصصة لتوسيع وظائف Gemini CLI.

- موقع التمديد:
يمكن أن تكون الإضافات في موقعين أساسيين: `/.gemini/extensions/` أو `/.gemini/extensions/`. يقوم Gemini CLI بتحميل جميع الامتدادات الموجودة في كلا الموقعين على بدء التشغيل ، مع امتدادات الخاصة بمساحة العمل التي تتجاوز إصدارات الدليل المنزلي في حالة ظهور تعارضات.

- بنية التمديد:
كل ملحق هو دليل سمي على بعد الامتداد (على سبيل المثال ، "My-Extension`) يحتوي على ملف تكوين يسمى" Gemini-extension.json`. يتضمن هذا JSON تكوينات البيانات الوصفية والخادم.

- Gemini-extension.json المحتوى:
تتضمن المفاتيح النموذجية في هذا الملف:

- "الاسم": اسم تمديد فريد.
- "الإصدار": نسخة ملحق.
- `McPservers`: خريطة لخوادم MCP التي تم تكوينها بواسطة الامتداد ، على سبيل المثال ، أوامر لإطلاق خوادم MCP مخصصة.
- "contextFilename": اختياري. اسم ملف السياق الذي تم تحميله كسياق مساحة عمل للامتداد ، والإعدادات الافتراضية إلى `gemini.md`.
- `qustileTools`: Array تحديد الأدوات أو أوامر الأدوات لاستبعادها ، مفيدة لحظر العمليات الخطرة أو غير المرغوب فيها.

- أوامر مخصصة في الامتدادات:
يمكن أن توفر الامتدادات أوامر SLASH مخصصة عن طريق وضع ملفات تعريف الأوامر ".Toml` داخل أوامر/" دليل فرعي داخل دليل الامتداد. يتم تعريف هذه الأوامر بشكل مشابه للأوامر الخاصة بالمستخدم أو المشروع.

- دمج السلوك:
عند بدء تشغيل Gemini CLI ، يدمج تكوينات الامتداد مع الإعدادات الرئيسية للمستخدم والأدوات المدمجة ، وحل التعارضات من خلال إعطاء أولوية إعدادات مساحة العمل.

إنشاء أوامر مائلة مخصصة مع ملفات TOML

هناك طريقة مرنة لإضافة أوامر (أدوات) قابلة لإعادة الاستخدام هي باستخدام ملفات .toml` كأوامر مائلة مخصصة.

- موقع:
ضع ملفات أوامر TOML في `~/.gemini/commands/` للأوامر العالمية أو في الدليل المحلي للمشروع `. gemini/`.

- تنسيق توم:
تحدد هذه الملفات الأمر ، والقوالب المطالبة ، وقد تتضمن وسيطات مع أصحاب نائبة مثل ``. كما يدعمون تنفيذ الأوامر shell داخل المطالبة باستخدام بناء الجملة مثل `! {...}` لتضمين البرمجة النصية.

- الاستخدام:
يمكن استدعاء هذه الأوامر مباشرة في Gemini CLI من خلال أوامر SLASH مثل `/myCommand` ، تمكين سير العمل المكتوبة أو التكامل بسهولة.

تشغيل البرامج النصية المخصصة للبيثون وأوامر شل

- نظرًا لأن Gemini CLI يدعم تشغيل أوامر SHELL والبرامج النصية ، يمكنك تشغيل البرامج النصية المخصصة للبيثون أو البرامج الأخرى كجزء من خادم MCP أو سير عمل الأوامر المخصصة.

- على سبيل المثال ، يمكن لفّ برنامج PYTHON الذي يولد PDFs من استجابات Gemini CLI في خادم MCP أو تنفيذها كأمر shell في أمر TOML مخصص ، مما يتيح تدفقات عمل توليد ذات أهمية واحدة.

التكامل مع IDES والبيئة

- يمكن أن تعزز امتدادات Gemini CLI أيضًا التكامل مع IDEs مثل VS Code من خلال مشاركة سياق مساحة العمل (الملفات ، موقع المؤشر ، التحديدات) ، مما يتيح سير عمل مساعدة الرمز المدفوعة AI.

- تساعد الامتدادات وخوادم MCP في دمج سير العمل المصمم مباشرة في بيئة CLI أو IDE ، مما يؤدي إلى تحسين المرونة في الإنتاجية ومرونة أدوات الأدوات.

ملخص العملية لإضافة أدوات أو ملحقات مخصصة

1. حدد نطاق الأداة المخصصة:
حدد ما إذا كان الأمر مخصصًا بسيطًا أو برنامجًا نصيًا أو خدمة خارجية بالكامل.

2. للأوامر المخصصة البسيطة:
قم بإنشاء ملفات .toml` التي تحدد أوامر Slash ووضعها في مجلد الأوامر المناسب.

3. للخدمات الخارجية أو المنطق المعقد:
قم بتطوير خادم MCP باستخدام MCP SDK (دعم اللغات مثل Python أو TypeScript) الذي يعرض إمكانيات الأداة عبر API الموحدة.

4. تكوين خادم MCP في `settings.json` أو الامتداد:
أضف إدخال تكوين خادم MCP (مع الأمر أو عنوان URL) إما مباشرة في تكوين المستخدم `~/.gemini/settings.json` أو داخل ملف` gemini-extension.json` ضمن دليل تمديد.

5. حزمة اختياري في امتداد:
قم بتعبئة خوادم MCP وأوامر مخصصة وملفات السياق في بنية دليل التمديد ضمن `gemini/extensions/`.

6. ابدأ أو أعد تشغيل الجوزاء CLI:
يقوم Gemini CLI بتحميل جميع التكوينات وخوادم MCP على بدء التشغيل ، والأدوات المخصصة المدمجة تلقائيًا.

7. استخدام الأدوات والتحقق منها:
استخدم أوامر مثل `/mcp` و`/mcp desc `لتأكيد توافر الأداة والتفاعل مع الإضافات المخصصة الخاصة بك.

فوائد هذه الهندسة المعمارية

- Modularity: يتم تشغيل الأدوات كخوادم MCP منفصلة ، مما يجعل التطوير مستقلًا وقابل للتطوير.

- التكامل الديناميكي: تظهر الأدوات تلقائيًا في سير عمل Gemini CLI دون الترميز المتشددين.

- الأمن والتحكم: يمكن أن تحد الامتدادات الأدوات أو أوامر shell المسموح بها ، مما يمنع سوء الاستخدام.

- قابلية إعادة الاستخدام: حزمة الإضافات كاملة سير عمل ، قابلة للمشاركة عبر المشاريع أو الفرق.

- المجتمع والنظام الإيكولوجي: تتوفر العديد من خوادم MCP والملحقات أو يمكن المساهمة بها ، وتوسيع نطاق قدرات Gemini CLI.

تتيح هذه البنية فعليًا أي أداة أو نصية خارجية أو خدمة يتم دمجها في النظام البيئي Gemini CLI ، وتعزيز الإنتاجية والتخصيص.

***

توفر هذه الإجابة شرحًا شاملاً لآليات تكامل الجوزاء CLI وآليات تكامل الامتداد ، بما في ذلك خوادم MCP ، وتعبئة التمديد ، والأوامر المخصصة ، وتكامل البرمجة النصية ، وتلبية الطول والتفاصيل المطلوبة. إذا رغبت في ذلك ، يمكن توفير المزيد من التفاصيل حول استخدام MCP SDK أو تكوينات المثال بعد ذلك.