ربط Gemini CLI بمنصة Looker باستخدام MCP Toolbox

1. قبل البدء

يجب أن يكون لديك إذن الوصول إلى نسخة Looker قيد التشغيل. ستحتاج إلى client_id وclient_secret من واجهة برمجة التطبيقات.

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

  • يجب أن تكون لديك نسخة Looker قيد التشغيل
  • يجب أن يكون لديك إذن الوصول إلى سطر أوامر Linux أو macOS

المواضيع التي ستتعرّف عليها

  • كيفية تثبيت Gemini CLI
  • كيفية تثبيت MCP Toolbox
  • كيفية ربط Gemini CLI بمنصة Looker باستخدام MCP Toolbox

المتطلبات

  • عنوان URL لخادم Looker API عادةً ما يكون هو نفسه عنوان URL لمنصة Looker، ولكن قد تحتاج إلى إلحاق رقم منفذ، مثل :19999، على سبيل المثال: https://looker.example.com:19999 إذا لم تنجح هذه الخطوات، حاوِل التواصل مع مشرف Looker.

2. التحضيرات

عليك استرداد client_id وclient_secret.

سجِّل الدخول إلى نسخة Looker وانقر على الملف الشخصي للمستخدم في أعلى يسار الشاشة. اختَر الحساب. في شاشة "الحساب"، بجانب التصنيف API Keys، انقر على الزر Manage.

في صفحة إدارة مفاتيح واجهة برمجة التطبيقات ، انقر على الزر Create New API Key.

في الإدخال الذي تم إنشاؤه حديثًا، أضِف الغرض MCP Toolbox أو عبارة مشابهة وانقر على علامة الاختيار لحفظه. بعد ذلك، انسخ client_id وclient_secret والصقهما في مكان آمن. عليك النقر على رمز العين بجانب السر للاطّلاع عليه ونسخه.

يمكنك الآن إغلاق نوافذ متصفّح Looker.

3. تثبيت Gemini CLI

افتح تطبيق Terminal للوصول إلى سطر أوامر macOS أو Linux.

نفِّذ الأمر التالي:

npm install -g @google/gemini-cli

إذا تعذّر ذلك لأي سبب، يمكنك الرجوع إلى https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation للاطّلاع على خيارات التثبيت أو الحصول على المساعدة.

الآن، شغِّل Gemini CLI باستخدام هذا الأمر:

gemini

سيُطلب منك تسجيل الدخول. اتّبِع هذه التعليمات وستكون جاهزًا.

4. تثبيت MCP Toolbox

إنشاء دليل MCP Toolbox

في تطبيق Terminal، أنشئ دليلاً باسم mcp-toolbox. بعد ذلك، انتقِل إلى هذا الدليل:

mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox

تحديد بنية النظام

نفِّذ الأمر uname لمعرفة نوع النظام الذي تستخدمه:

uname -a

سيعرض هذا الأمر سلسلة مشابهة لما يلي:

Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux

انتبه جيدًا إلى نهاية هذا السطر. إذا كنت تستخدم Linux، سينتهي السطر بـ x86_64 GNU/Linux. بالنسبة إلى macOS، سيشير إلى Darwin وarm64 لمعالج Apple أو x86_64 i386 لمعالج Intel بالقرب من نهاية هذه السلسلة.

تنزيل MCP Toolbox

إذا كنت تستخدم Linux، نفِّذ الأمر التالي لتنزيل MCP Toolbox:

curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox

إذا كنت تستخدم macOS مع معالج Apple، نفِّذ الأمر التالي لتنزيل MCP Toolbox:

curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox

إذا كنت تستخدم macOS مع معالج Intel، نفِّذ الأمر التالي لتنزيل MCP Toolbox:

curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox

جعل MCP Toolbox قابلاً للتنفيذ

اجعل برنامج MCP Toolbox قابلاً للتنفيذ عن طريق تشغيل الأمر التالي:

chmod +x toolbox

الحصول على المسار الكامل إلى مجموعة الأدوات

احصل على المسار الكامل إلى ملف مجموعة الأدوات عن طريق تشغيل الأمر التالي:

echo $HOME/mcp-toolbox/toolbox

من المحتمل أن تكون النتيجة مشابهة لما يلي:

/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox

احفظ النتيجة في مكان مناسب.

5. ضبط إعدادات Gemini CLI

عدِّل الملف $HOME/.gemini/settings.json. استخدِم محرِّر النصوص الذي تفضّله. إذا لم تكن تعدِّل الملفات في Linux أو macOS بشكل متكرّر، يُعدّ nano خيارًا جيدًا.

أضِف المقطع التالي إلى ملف JSON:

  "mcpServers": {
    "looker": {
      "command": "FULL_PATH_TO_TOOLBOX",
      "args": [
        "--stdio",
        "--prebuilt",
        "looker"
      ],
      "env": {
        "LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
        "LOOKER_CLIENT_ID": "CLIENT_ID",
        "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
        "LOOKER_VERIFY_SSL": "true"
      }
    }
  }

استبدِل المعلومات التي حفظتها في الخطوات السابقة بـ FULL_PATH_TO_TOOLBOX وURL_OF_LOOKER_INSTANCE وCLIENT_ID وCLIENT_SECRET. احفظ الملف المُعدّل.

6. استخدام MCP Toolbox مع Gemini CLI

ابدأ Gemini CLI عن طريق إدخال gemini في سطر الأوامر.

اعرض الأدوات المتاحة عن طريق كتابة ما يلي في طلب مُوجَّه إلى Gemini:

/mcp list looker

يجب أن تبدو النتيجة مشابهة لما يلي:

Configured MCP servers:

🟢 looker - Ready (33 tools)
  Tools:
  - add_dashboard_element
  - add_dashboard_filter
  - create_project_file
  - delete_project_file
  - dev_mode
  - generate_embed_url
  - get_connection_databases
  - get_connection_schemas
  - get_connection_table_columns
  - get_connection_tables
  - get_connections
  - get_dashboards
  - get_dimensions
  - get_explores
  - get_filters
  - get_looks
  - get_measures
  - get_models
  - get_parameters
  - get_project_file
  - get_project_files
  - get_projects
  - health_analyze
  - health_pulse
  - health_vacuum
  - make_dashboard
  - make_look
  - query
  - query_sql
  - query_url
  - run_dashboard
  - run_look
  - update_project_file

ابدأ الآن في طرح أسئلة على Gemini CLI حول البيانات المتاحة. جرِّب بعضًا مما يلي:

  1. ما هي النماذج المتاحة في Looker؟
  2. ما هي مستكشفات البيانات المتاحة في MODEL_NAME؟
  3. ما هي المقاييس والمكوّنات المتاحة في EXPLORE_NAME؟

استبدِل MODEL_NAME وEXPLORE_NAME بالقيم الخاصة بك.

بعد ذلك، حاوِل إجراء بعض طلبات البحث باللغة العادية التي يمكن الإجابة عنها باستخدام البيانات في نسخة Looker: "ما هو إجمالي إيراداتي لعام 2025؟"، "كم عدد الأدوات التي بعتها في الربع الرابع؟"، وما إلى ذلك.

7. المزيد من الطلبات لتجربتها

يمكنك أيضًا محاولة تشغيل "المظاهر" ولوحات البيانات المحفوظة، وإنشاء "المظاهر" ولوحات البيانات، وحتى تعديل نماذج LookML.

  • شغِّل "مظهرًا" محفوظًا عن طريق إدخال طلب، مثل "تشغيل المظهر "المخزون الشهري"‏". يجب أن يبحث Gemini عن "مظهر" باسم "المخزون الشهري"، ثم يشغِّل طلب البحث المرتبط ويشارك النتائج.
  • شغِّل لوحة بيانات عن طريق تقديم طلب، مثل "تلخيص لوحة البيانات "تتبُّع العملاء"‏". يجب أن يبحث Gemini عن لوحة بيانات باسم "تتبُّع العملاء"، ويشغِّل طلبات البحث المرتبطة بكل مربّع، ويقدّم ملخصًا.
  • لإنشاء "مظهر" محفوظ، جرِّب طلبًا، مثل "إنشاء "مظهر" لتتبُّع إيراداتي الشهرية مقسّمة حسب فئة المنتج. عرض البيانات كرسم بياني عمودي مكدّس".
  • لإنشاء لوحة بيانات، جرِّب طلبًا، مثل "إنشاء لوحة بيانات لمراقبة المبيعات لعام 2026".

إذا كنت مطوّر LookML، يمكنك تعديل LookML باستخدام Gemini. جرِّب طلبات مثل ما يلي:

  1. اطلب من Gemini الحصول على قائمة بمشاريع LookML باستخدام "ما هي مشاريع LookML المتاحة؟".
  2. اطلب من Gemini استرداد قائمة بملفات المشروع. "ما هي الملفات المتاحة في المشروع PROJECT_NAME؟" استبدِل اسم المشروع الخاص بك.
  3. اطلب من Gemini إضافة مقياس. "إنشاء مقياس لحساب متوسط حقل sales_price في طريقة العرض VIEW_NAME". استبدِل اسم طريقة العرض الخاصة بك.
  4. استرداد قائمة الاتصالات باستخدام "ما هي الاتصالات المتاحة في Looker؟".
  5. الحصول على المخططات المرتبطة "ما هي المخططات في CONNECTION_NAME؟" استبدِل اسم الاتصال الخاص بك.
  6. الحصول على الجداول المرتبطة "ما هي الجداول في CONNECTION_NAME في المخطط SCHEMA_NAME؟" استبدِل أسماء الاتصال والمخطط الخاصة بك.
  7. الحصول على أعمدة جدول "ما هي الأعمدة في TABLE_NAME؟" استبدِل اسم الجدول الخاص بك.
  8. اطلب الآن من Gemini إضافة عمود إلى طريقة عرض LookML. "إنشاء سمة للعمود COLUMN_NAME". استبدِل اسم العمود الخاص بك.

استخدِم واجهة مستخدم Looker لاختبار التغييرات وإمكانية تنفيذها. لا يمكن لـ Gemini وMCP Toolbox تنفيذ تغييرات LookML ونشرها.

8. معلومات إضافية