חיבור של Gemini CLI ל-Looker באמצעות MCP Toolbox

1. לפני שתתחיל

צריכה להיות לכם גישה למכונה פעילה של Looker. תצטרכו מזהה לקוח (client_id) וסוד לקוח (client_secret) של API.

דרישות מוקדמות

  • יש לכם מופע פעיל של Looker
  • גישה לשורת פקודה ב-Linux או ב-macOS

מה תלמדו

  • איך מתקינים את Gemini CLI
  • איך מתקינים את MCP Toolbox
  • איך מקשרים את Gemini CLI ל-Looker באמצעות MCP Toolbox

מה תצטרכו

  • כתובת ה-URL של שרת Looker API. בדרך כלל כתובת ה-URL הזו זהה לכתובת ה-URL של Looker, אבל יכול להיות שתצטרכו להוסיף מספר יציאה כמו :19999. לדוגמה: https://looker.example.com:19999. אם משהו לא עובד כמו שצריך, כדאי לפנות לאדמין שלכם ב-Looker.

2. הכנות

צריך לאחזר את הערכים client_id ו-client_secret.

מתחברים למופע Looker ולוחצים על פרופיל המשתמש בפינה השמאלית העליונה של המסך. בוחרים באפשרות חשבון. במסך החשבון, ליד התווית API Keys, לוחצים על הלחצן Manage.

בדף הניהול API Keys (מפתחות API), לוחצים על הלחצן Create New API Key.

בפריט החדש שנוצר, מוסיפים את המטרה MCP Toolbox או משהו דומה ולוחצים על סימן הוי כדי לשמור אותו. אחר כך מעתיקים ומדביקים את client_id ואת client_secret במקום בטוח. כדי לראות את הסוד ולהעתיק אותו, צריך ללחוץ על סמל העין לצד הסוד.

עכשיו אפשר לסגור את חלונות הדפדפן של Looker.

3. התקנת Gemini CLI

פותחים את אפליקציית הטרמינל כדי להגיע לשורת פקודה ב-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/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 לקובץ הפעלה

כדי להפוך את התוכנה 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 בשורת הפקודה כדי להפעיל את Gemini CLI.

כדי לראות את רשימת הכלים הזמינים, מקלידים את ההנחיה הבאה ב-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 שלכם: "What is my total revenue for 2025?" (מהו סך ההכנסות שלי בשנת 2025?), "כמה ווידג'טים מכרתי ברבעון הרביעי?" וכו'.

7. עוד הנחיות שאפשר לנסות

אתם יכולים גם לנסות להריץ טבלאות Look ומרכזי בקרה שמורים, ליצור טבלאות Look ומרכזי בקרה, ואפילו לערוך מודלים של LookML.

  • מריצים Look שמור על ידי הזנת הנחיה כמו 'הפעלת ה-Look 'מלאי חודשי''. ‫Gemini צריך לחפש לוח בקרה בשם 'מלאי חודשי', להריץ את השאילתה שמשויכת אליו ולשתף את התוצאות.
  • מריצים לוח בקרה באמצעות הנחיה כמו "תסכם את לוח הבקרה 'מעקב אחרי לקוחות'". ‫Gemini צריך לחפש מרכז בקרה בשם 'customer tracking', להריץ את השאילתות שמשויכות לכל משבצת ולתת סיכום.
  • כדי ליצור תצוגה שמורה, אפשר להשתמש בהנחיה כמו 'צור תצוגה כדי לעקוב אחרי ההכנסות החודשיות שלי, עם פירוט לפי קטגוריית מוצרים. הצגת הנתונים בתרשים עמודות אנכי מוערם".
  • כדי ליצור לוח בקרה, אפשר לנסות הנחיה כמו "תבנה לי לוח בקרה של נתוני מכירות לשנת 2026".

מפתחי LookML יכולים לשנות את LookML באמצעות Gemini. נסו הנחיות כמו אלה:

  1. מזינים הנחיה ל-Gemini כדי לקבל את רשימת הפרויקטים של LookML, למשל: "אילו פרויקטים של LookML זמינים?"
  2. מבקשים מ-Gemini לאחזר את רשימת קבצי הפרויקט. "אילו קבצים זמינים בפרויקט PROJECT_NAME?" מחליפים את שם הפרויקט.
  3. מנחים את Gemini להוסיף מדד. ‫"Create a measure to average the sales_price field in view VIEW_NAME." מחליפים את שם התצוגה בשם שלכם.
  4. אחזור רשימת החיבורים באמצעות השאלה 'אילו חיבורים זמינים ב-Looker?'
  5. קבלת הסכימות המשויכות. "What schemas are in CONNECTION_NAME?) מחליפים את שם החיבור בשם שלכם.
  6. קבלת הטבלאות המשויכות. "אילו טבלאות יש ב-CONNECTION_NAME בסכימה SCHEMA_NAME?" מחליפים את שמות החיבור והסכימה בשמות שלכם.
  7. קבלת העמודות של טבלה. "What columns are in TABLE_NAME?) מחליפים את שם הטבלה בשם שלכם.
  8. עכשיו מבקשים מ-Gemini להוסיף עמודה לתצוגת LookML. ‫"Create a dimension for the column COLUMN_NAME). מחליפים את שם העמודה בשם שלכם.

אפשר להשתמש בממשק המשתמש של Looker כדי לבדוק את השינויים ולבצע אותם. אי אפשר לבצע שינויי LookML בארגז הכלים של Gemini ו-MCP ולדחוף אותם לסביבת הייצור.

8. מידע נוסף