שימוש ב-MCP Toolbox for Databases
בדף הזה מוסבר איך משתמשים ב-MCP Toolbox for Databases כדי לחבר את מכונת Looker לסביבות פיתוח משולבות (IDE) ולכלים למפתחים שתומכים ב-Model Context Protocol (MCP). ארגז הכלים של MCP הוא אפשרות טובה אם אתם משתמשים באירוח בצד הלקוח, או אם אתם מעדיפים לנהל את התשתית שלכם בעצמכם. אחרת, מומלץ להשתמש בשרת MCP בניהול Looker.
מומלץ להשתמש בתוסף הייעודי של Looker ל-Gemini CLI עם MCP Toolbox. משתמשים בשכבה הסמנטית של Looker כדי לספק ל-Gemini CLI גישה מאובטחת, מנוהלת ועל פי דרישה לנתונים מהימנים, ולהאיץ את תהליכי העבודה על ידי אוטומציה של יצירת דוחות, תצוגות חזותיות ומרכזי בקרה מהנחיות בשפה טבעית. Gemini CLI הוא ממשק שורת הפקודה של Google Cloudמהדור הבא, והוא הכלי המומלץ לאינטראקציה עם המכונות של Looker משורת הפקודה.
אתם יכולים גם לחבר סביבות פיתוח משולבות (IDE) אחרות וכלים למפתחים שתומכים ב-Model Context Protocol (MCP) באמצעות MCP Toolbox for Databases לשימוש כללי. MCP Toolbox הוא שרת MCP בקוד פתוח שמאפשר לסוכני AI להתחבר בקלות לנתונים שלכם. הוא מטפל במשימות מורכבות כמו אימות ואיגוד חיבורים, וכך מאפשר לכם לקיים אינטראקציה עם הנתונים שלכם באמצעות שפה טבעית ישירות מה-IDE. בכלים האלה, השיטה הזו מספקת יכולות אינטראקציה בסיסיות עם מסד הנתונים.
מידע על Gemini CLI ותוספים
Gemini CLI הוא סוכן AI בקוד פתוח שנועד להאיץ את תהליכי הפיתוח על ידי סיוע בכתיבת קוד, בניפוי באגים, בניתוח נתונים וביצירת תוכן. המטרה שלו היא לספק חוויית שימוש אלגנטית בסוכן לאינטראקציה עם שירותי Data Cloud ומסדי נתונים פופולריים בקוד פתוח.
איך תוספים פועלים
Gemini CLI הוא כלי מאוד גמיש, ואפשר להוסיף לו כלים ויכולות חדשים באמצעות תוספים. קל להתקין את התוספים האלה. אפשר לטעון אותם מכתובת URL של GitHub, מספרייה מקומית או ממרשם שניתן להגדרה. התוספים האלה מספקים מגוון רחב של יכולות, כולל כלים חדשים, פקודות דרך שורת הפקודות והנחיות לייעול תהליך העבודה.
הכנת האימות ב-Looker
יש שתי אפשרויות לאימות של לקוח ה-MCP באמצעות Looker: אתם יכולים להשתמש בפרטי כניסה רגילים ל-API או לאמת את הלקוח באמצעות רישום אפליקציה ב-OAuth.
אפשרות 1: פרטי הכניסה של ה-API
- מקבלים מזהה לקוח וסוד לקוח של Looker. פועלים לפי ההוראות שבדף התיעוד בנושא אימות Looker API.
- כתובת ה-URL הבסיסית של המכונה של Looker צריכה להיות זמינה. הוא אמור להיראות בערך כך:
https://looker.example.com. במקרים מסוימים ה-API מאזין ליציאה אחרת, ואז צריך להשתמש ב-https://looker.example.com:19999.
אפשרות 2: רישום אפליקציית OAuth
פותחים את Looker API Explorer.
API Explorer הותקן
אם ה-API Explorer כבר מותקן במכונה של Looker, אתם יכולים לגשת אליו באמצעות הפורמט הבא של כתובת URL:
LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/API Explorer לא מותקן
אם במכונה של Looker אין את API Explorer, אתם יכולים להתקין אותו מ-Looker Marketplace. במאמר שימוש ב-API Explorer מוסבר איך להתקין את API Explorer.
מכונה פרטית של PSA
אם אתם משתמשים במכונה של Looker (Google Cloud core) עם חיבורים פרטיים שמשתמשת בגישה לשירותים פרטיים, אין תמיכה ב-Looker Marketplace וב-API Explorer. כדי לרשום סוכן AI, צריך לשלוח קריאה ישירות לנקודת הקצה
oauth_client_appsל-API. אם אתם משתמשים בשיטה הזו, אתם יכולים לדלג על השלבים הבאים בתהליך הזה של API Explorer.הדוגמה הבאה מראה פקודת
curlשאפשר להשתמש בה עם נקודת הקצה (endpoint) שלoauth_client_appsכדי לרשום את הסוכן.curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \ -H "Authorization: token ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "redirect_uri": "REDIRECT_URI", "display_name": "CLIENT_NAME", "description": "OAuth client to access MCP server using CLIENT_NAME", "enabled": true }'בשיטת Auth, מוצאים את נקודת הקצה ל-API של Register OAuth App. אפשר גם לחפש "אפליקציית OAuth" בשדה חיפוש.
לוחצים על הפעלה.
בשדה
client_guid, מזינים מחרוזת בהתאמה אישית (לדוגמה,gemini_cliאוclaude-desktop).בגוף הבקשה, מזינים את הגדרת ה-JSON הבאה:
{ "redirect_uri": "AI_AGENT_REDIRECT_URI", "display_name": "APPLICATION_NAME", "description": "APPLICATION_DESCRIPTION", "enabled": true }מחליפים את מה שכתוב בשדות הבאים:
AI_AGENT_REDIRECT_URI: ה-URI להפניה אוטומטית של התוסף לסוכן ה-AI או של אפליקציית השירות המשותף.- באפליקציות שמתארחות בענן, היא יכולה להיראות כמו כתובת URL מאובטחת מסוג HTTPS:
https://AI_AGENT_URL/oauth2callback באפליקציות שפועלות באופן מקומי, זו צריכה להיות כתובת URL של מארח מקומי עם יציאה סטטית:
http://localhost:7777/oauth/callbackבסביבות פיתוח משולבות (IDE), זה יכול להיראות כך:
vscode://google.vscode-looker-official/oauth_callback
- באפליקציות שמתארחות בענן, היא יכולה להיראות כמו כתובת URL מאובטחת מסוג HTTPS:
APPLICATION_NAME: השם המוצג של אפליקציית OAuth, לדוגמהClaude Desktop.
APPLICATION_DESCRIPTION: תיאור קצר של אפליקציית OAuth.
מסמנים את תיבת האישור לצד I understand that this API endpoint will change data, ואז לוחצים על Run.
התקנת MCP Toolbox
מורידים את הגרסה העדכנית של MCP Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת המעבד (CPU). צריך להשתמש בגרסה V1.0.0 ואילך של MCP Toolbox.
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/windows/amd64/toolbox.exe
הופכים את הקובץ הבינארי לקובץ הפעלה.
chmod +x toolboxמאמתים את ההתקנה.
./toolbox --version
הפעלת MCP Toolbox כשירות משותף
בלקוחות MCP שדורשים אימות OAuth דרך HTTPS, צריך לפרוס את MCP Toolbox מאחורי שרת proxy הפוך של HTTPS (כמו Cloud Run). שרת ה-proxy ההפוך מסיים את ה-SSL ומעביר את הבקשות לקונטיינר של MCP Toolbox.
הגדרת סביבת השרת
מגדירים את משתני הסביבה הבאים בפריסה:
LOOKER_BASE_URL=YOUR_LOOKER_BASE_URLLOOKER_USE_CLIENT_OAUTH=true
מריצים את MCP Toolbox עם הארגומנטים הבאים:
--prebuilt=looker,looker-dev--mcp-prm-file=prm.json[--address=0.0.0.0][--port=8080]
בדרך כלל, MCP Toolbox מאזין ליציאה
5000ב-127.0.0.1. אם שרת ה-proxy ההפוך נמצא במארח אחר, צריך להשתמש ב---address=0.0.0.0כדי לקשר לכל כתובות ה-IP. אם אתם צריכים להשתמש ביציאת האזנה אחרת מ-5000, השתמשו בהגדרה--port=. לדוגמה, Cloud Run מעביר באופן אוטומטי תנועה חיצונית מיציאה443, יציאת ה-HTTPS, אל8080.יוצרים קובץ תצורה של מטא-נתונים של משאבים מוגנים (PRM) (
prm.json) במבנה הבא:{ "resource": "https://PROXY_URL/mcp", "authorization_servers": ["LOOKER_URL"], "scopes_supported": ["cors_api"] }מחליפים את מה שכתוב בשדות הבאים:
-
PROXY_URL: הדומיין ונתיב הבסיס של שרת ה-proxy ההפוך. -
LOOKER_URL: כתובת ה-URL הבסיסית של המכונה שלכם ב-Looker.
-
דוגמה להגדרת הלקוח כשמפעילים את MCP Toolbox כשירות משותף מופיעה בקטע הגדרת Claude למחשב.
הגדרת לקוח ה-MCP
בקטע הזה מוסבר איך להגדיר כלים שונים למפתחים כדי להתחבר למכונה של Looker באמצעות MCP Toolbox for Databases. ארגז הכלים פועל כשרת Model Context Protocol (MCP) בקוד פתוח שנמצא בין ה-IDE למסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלי ה-AI. כדי לראות את הוראות ההגדרה, בוחרים בכרטיסייה של הכלי הספציפי.
- Gemini CLI
- Gemini Code Assist
- Claude code
- Claude למחשב
- Cline (תוסף ל-VS Code)
- Cursor
- Visual Studio Code (Copilot)
- Windsurf (Codium)
Gemini CLI
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי כניסה ל-API עם תוסף
- מתקינים את Gemini CLI.
- מתקינים את התוסף של Looker ל-Gemini CLI מהמאגר ב-GitHub באמצעות הפקודה הבאה:
gemini extensions install https://github.com/gemini-cli-extensions/looker
- מגדירים משתני סביבה כדי להתחבר למכונה של Looker, ומחליפים את משתני הסביבה הבאים בערכים שלכם:
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL:trueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
export LOOKER_BASE_URL="LOOKER_URL" export LOOKER_CLIENT_ID="CLIENT_ID" export LOOKER_CLIENT_SECRET="CLIENT_SECRET" export LOOKER_VERIFY_SSL="VERIFY_SSL"
-
- מפעילים את Gemini CLI במצב אינטראקטיבי:
ה-CLI טוען באופן אוטומטי את התוסף של Looker ל-Gemini CLI ואת הכלים שלו, שבהם אתם יכולים להשתמש כדי לבצע פעולות במכונה של Looker.gemini
אפשרות 2: שירות משותף מרחוק עם OAuth
כדי להתחבר לשירות משותף מרחוק באמצעות OAuth, אל תתקינו את התוסף של Looker. במקום זאת, מגדירים את Gemini CLI כך שיתחבר ישירות לשרת ה-MCP המרוחק.
- מתקינים את Gemini CLI.
- מוסיפים את שרת ה-MCP המרוחק באמצעות הפקודה הבאה, ומחליפים את
PROXY_URLבדומיין של שרת ה-proxy ההפוך:gemini mcp add --transport http looker https://PROXY_URL/mcp
לחלופין, אפשר להגדיר את זה ידנית על ידי הוספת ההגדרות הבאות לקובץ
settings.json(שנמצא ב-~/.gemini/settings.jsonאו בספריית הפרויקט):{ "mcpServers": { "looker": { "httpUrl": "https://PROXY_URL/mcp" } } } - מפעילים את Gemini CLI במצב אינטראקטיבי:
כשמופיעה בקשה להתחבר, ה-CLI מתחיל את תהליך ההרשאה של OAuth כדי לבצע אימות מאובטח מול המכונה של Looker.gemini
Gemini Code Assist
מומלץ להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI. ככה לא צריך להגדיר שרת MCP באופן ידני.
- מוודאים שהתקנתם והגדרתם את Gemini CLI ואת התוסף
looker(לפרטי כניסה ל-API) או הגדרה של שרת MCP מרוחק (לשירות משותף עם OAuth). - הגדרת Gemini Code Assist לשימוש ב-Gemini CLI
- אתם יכולים להתחיל אינטראקציה עם המכונה של Looker באמצעות שפה טבעית ישירות בצ'אט של Gemini Code Assist.
Claude Code
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי הכניסה של ה-API
- מתקינים את Claude Code.
- יוצרים את הקובץ
.mcp.jsonבתיקיית הבסיס של הפרויקט, אם הוא לא קיים. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה הבאים בערכים שלכם ואז שומרים.
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL:trueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
-
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
אפשרות 2: שירות משותף מרחוק עם OAuth
- מתקינים את Claude Code.
- יוצרים את הקובץ
.mcp.jsonבתיקיית הבסיס של הפרויקט, אם הוא לא קיים. - מוסיפים את ההגדרות הבאות, מחליפים את
PROXY_URLבדומיין של שרת ה-proxy ההפוך, ואז שומרים.
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
Claude במחשב
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי הכניסה של ה-API
- פותחים את Claude במחשב ועוברים אל הגדרות.
- בכרטיסייה Developer, לוחצים על Edit Config כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה הבאים בערכים שלכם ואז שומרים.
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL:trueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
-
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
אפשרות 2: שירות משותף מרחוק עם OAuth
- ב-Claude למחשב, עוברים אל הגדרות ובוחרים באפשרות מחברים.
- בוחרים באפשרות הוספת מחבר בהתאמה אישית ומזינים שם (לדוגמה, Looker).
- בשדה של כתובת ה-URL, מזינים את נקודת הקצה של שרת ה-proxy ההפוך עם הנתיב
/mcp(לדוגמה,https://looker-mcp-toolbox.example.com/mcp). - בקטע הגדרות מתקדמות, מזינים את המחרוזת המדויקת שבה השתמשתם בשביל
client_guidבמהלך רישום אפליקציית OAuth. משאירים את השדה "סוד לקוח OAuth" ריק. - לוחצים על הוספה כדי לשמור את המחבר. כשמופיעה בקשה להתחבר, אפליקציית Claude למחשב מפעילה באופן מאובטח את תהליך ההרשאה של PKCE דרך הדפדפן.
- מפעילים מחדש את Claude במחשב.
Cline
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי הכניסה של ה-API
- פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל שרתי MCP.
- לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה הבאים בערכים שלכם ואז שומרים.
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL: הערךtrueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
-
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
אפשרות 2: שירות משותף מרחוק עם OAuth
- פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל שרתי MCP.
- לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את
PROXY_URLבדומיין של שרת ה-proxy ההפוך, ואז שומרים.
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
סמן
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי הכניסה של ה-API
- אם הספרייה
.cursorלא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה. - יוצרים את הקובץ
.cursor/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה הבאים בערכים שלכם ואז שומרים.
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL: הערךtrueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
-
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
- פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.
אפשרות 2: שירות משותף מרחוק עם OAuth
- אם הספרייה
.cursorלא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה. - יוצרים את הקובץ
.cursor/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרות הבאות, מחליפים את
PROXY_URLבדומיין של שרת ה-proxy ההפוך, ואז שומרים.
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
- פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.
Visual Studio Code (Copilot)
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי הכניסה של ה-API
- פותחים את VS Code ויוצרים את הספרייה
.vscodeברמה הבסיסית של הפרויקט, אם היא לא קיימת. - יוצרים את הקובץ
.vscode/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה הבאים בערכים שלכם ואז שומרים.
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL:trueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
-
{
"servers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
אפשרות 2: שירות משותף מרחוק עם OAuth
- פותחים את VS Code ויוצרים את הספרייה
.vscodeברמה הבסיסית של הפרויקט, אם היא לא קיימת. - יוצרים את הקובץ
.vscode/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרות הבאות, מחליפים את
PROXY_URLבדומיין של שרת ה-proxy ההפוך, ואז שומרים.
{
"servers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
גלישת רוח
בוחרים את שיטת החיבור בהתאם לשיטת האימות שבחרתם:
אפשרות 1: פרטי הכניסה של ה-API
- פותחים את Windsurf ועוברים אל Cascade Assistant.
- לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה הבאים בערכים שלכם ואז שומרים.
-
LOOKER_URL: כתובת ה-URL של המכונה ב-Looker. -
CLIENT_IDו-CLIENT_SECRET: מפתח ה-API שמשמש לגישה אל Looker API. -
VERIFY_SSL:trueאוfalse, בהתאם לשימוש בהצפנת SSL כדי לחבר את מסד הנתונים למכונה של Looker.
-
{
"mcpServers": {
"looker-toolbox": {
"command": "./PATH/TO/toolbox",
"args": ["--stdio", "--prebuilt", "looker"],
"env": {
"LOOKER_BASE_URL": "LOOKER_URL",
"LOOKER_CLIENT_ID": "CLIENT_ID",
"LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
"LOOKER_VERIFY_SSL": "VERIFY_SSL",
}
}
}
}
אפשרות 2: שירות משותף מרחוק עם OAuth
- פותחים את Windsurf ועוברים אל Cascade Assistant.
- לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את
PROXY_URLבדומיין של שרת ה-proxy ההפוך, ואז שומרים.
{
"mcpServers": {
"looker-toolbox": {
"type": "http",
"url": "https://PROXY_URL/mcp"
}
}
}
שימוש בכלים מבוססי-AI
כלי ה-AI שלכם מחובר עכשיו ל-Looker באמצעות MCP. נסו לבקש מהעוזר האישי מבוסס-AI לפרט מודלים, Explores, מאפיינים ומדדים. אפשר גם להריץ שאילתה על ידי אחזור ה-SQL של שאילתה או הרצת Look שמור.
הכלים הבאים זמינים ל-LLM:
כלי המודלים והשאילתות של Looker
הכלים האלה משמשים לקבלת מידע על מודל Looker ולהרצת שאילתות על המודל הזה.
-
get_models: הצגת רשימה של כל המודלים של LookML במכונה של Looker. -
get_explores: הצגת רשימה של ה-Explore במודל נתון. -
get_dimensions: הצגת המאפיינים בניתוח נתונים מסוים. -
get_measures: הצגת רשימה של המדדים ב-Explore נתון. -
get_filters: הצגת רשימה של המסננים ב-Explore נתון. -
get_parameters: הצגת רשימה של הפרמטרים בניתוח נתונים מסוים. -
query: הרצת שאילתה והחזרת הנתונים. -
query_sql: החזרת ה-SQL שנוצר על ידי Looker לשאילתה. -
query_url: החזרת קישור לשאילתה ב-Looker להמשך ניתוח.
כלי תוכן של Looker
הכלים האלה מקבלים תוכן שמור (תצוגות ומרכזי בקרה) ממכונה של Looker ויוצרים תוכן שמור חדש.
-
get_looks: החזרת ה-Looks השמורים שתואמים לכותרת או לתיאור. -
run_look: הרצת Look שמור והחזרת הנתונים. -
make_look: יצירת Look שמור ב-Looker והחזרת כתובת ה-URL. -
get_dashboards: החזרת מרכזי הבקרה השמורים שתואמים לשם או לתיאור. -
make_dashboard: יוצרים מרכז בקרה שמור ב-Looker ומחזירים את כתובת ה-URL. -
add_dashboard_element: הוספת משבצת למרכז בקרה.
כלים לבדיקת התקינות של מכונות Looker
הכלים האלה מציעים את אותם אלגוריתמים לבדיקת תקינות שמציע ה-CLI הפופולרי Henry.
-
health_pulse: בדיקת התקינות של מכונה ב-Looker. -
health_analyze: ניתוח השימוש באובייקט של Looker. -
health_vacuum: חיפוש רכיבי LookML שלא בשימוש.
כלי פיתוח ב-LookML
הכלים האלה מאפשרים למי שמפעיל אותם לכתוב ולשנות קובצי LookML, וגם לקבל את סכימת מסד הנתונים שנדרשת כדי לכתוב LookML בצורה יעילה.
-
dev_mode: הפעלה והשבתה של מצב פיתוח בסשן. יצירת LookML חייבת להתבצע במצב פיתוח. שאילתות שמופעלות במצב פיתוח משתמשות ב-LookML ששונה, כדי שתוכלו לבדוק את ההשפעה של השינויים שביצעתם. -
get_projects: קבלת רשימה של פרויקטים זמינים של LookML. -
get_project_files: קבלת רשימה של קובצי LookML בפרויקט. -
get_project_file: קבלת התוכן של קובץ LookML. -
create_project_file: יוצרים קובץ LookML חדש. -
update_project_file: שינוי של קובץ LookML קיים. -
delete_project_file: מחיקת קובץ LookML. -
get_connections: קבלת רשימת החיבורים. -
get_connection_schemas: קבלת רשימת הסכימות של חיבור. -
get_connection_databases: קבלת רשימת מסדי הנתונים של חיבור. -
get_connection_tables: קבלת רשימת הטבלאות של חיבור. -
get_connection_table_columns: קבלת רשימת העמודות של טבלה בחיבור.