ربط 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"

في تطبيق الوحدة الطرفية، أنشئ دليلًا 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"

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

curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox

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

curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox

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

curl https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox

جعل "مجموعة أدوات MCP" قابلة للتنفيذ

اجعل برنامج 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,looker-dev"
      ],
      "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.

  • تشغيل Look محفوظ من خلال إدخال طلب، مثل "تشغيل Look "المستودع الشهري" على Gemini البحث عن مظهر باسم "المستودع الشهري" (Monthly Inventory)، ثم تنفيذ طلب البحث المرتبط به ومشاركة النتائج.
  • تشغيل لوحة بيانات من خلال تقديم طلب مثل "لخِّص لوحة بيانات "تتبُّع العملاء". على Gemini البحث عن لوحة بيانات باسم "تتبُّع العملاء"، وتشغيل طلبات البحث المرتبطة بكل مربّع، وتقديم ملخّص.
  • لإنشاء Look محفوظ، جرِّب طلبًا مثل "أريد إنشاء Look لتتبُّع إيراداتي الشهرية مقسّمة حسب فئة المنتج". اعرض البيانات كرسوم بيانية عمودية مكدّسة".
  • لإنشاء لوحة بيانات، جرِّب طلبًا مثل "أنشئ لي لوحة بيانات لمتابعة أداء المبيعات لعام 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. معلومات إضافية