בדף הזה מוסבר איך לחבר את מכונת Cloud SQL לכלי פיתוח שונים מבוססי-AI, כולל:
- Gemini Code Assist
- Claude code
- Claude למחשב
- Codex
- Cline (תוסף ל-VS Code)
- Cursor
- Visual Studio Code (Copilot)
- Windsurf (Codeium)
- Antigravity
כדי ליהנות מחוויה משולבת, מומלץ להשתמש בתוסף הייעודי של Gemini CLI ל-Cloud SQL ל-MySQL.
Gemini CLI הוא ממשק שורת הפקודה של Google Cloudמהדור הבא, והוא כולל את המיומנויות הבסיסיות ישירות בתוסף, מה שמפשט את ההגדרה וההתאמה האישית. אתם יכולים להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI, וכך ליהנות מיתרונות דומים של הגדרה ב-IDE.
בכלים אחרים למפתחים שתומכים ב-Model Context Protocol (MCP), אתם יכולים להתחבר באמצעות הגדרה ידנית של MCP Toolbox for Databases (Toolbox). Toolbox הוא שרת MCP בקוד פתוח שמחבר סוכני AI לנתונים שלכם על ידי ניהול משימות כמו אימות ואיגוד חיבורים. כך תוכלו לבצע פעולות בנתונים באמצעות שפה טבעית ישירות מסביבת הפיתוח המשולבת (IDE). בכלים האלה, השיטה הזו מספקת יכולות אינטראקציה בסיסיות עם מסד הנתונים.
מידע נוסף זמין במאמרים כלים מובנים ו-MCP Toolbox for Databases ב-GitHub.
מידע על Gemini CLI ותוספים
Gemini CLI הוא סוכן AI בקוד פתוח שעוזר בתהליכי פיתוח, כמו תכנות, ניפוי באגים, חקירת נתונים ויצירת תוכן. הוא מספק ממשק מבוסס-סוכן לאינטראקציה עם שירותי מסדי נתונים וניתוח נתונים, ועם מסדי נתונים פופולריים בקוד פתוח.
איך תוספים פועלים
Gemini CLI הוא כלי מאוד גמיש, ואפשר להוסיף לו כלים ויכולות חדשים באמצעות תוספים. אפשר לטעון את התוספים מכתובת URL ב-GitHub, מספרייה מקומית או ממרשם שניתן להגדרה. הם מספקים כלים חדשים, פקודות דרך שורת הפקודות, מיומנויות והנחיות שיעזרו לכם בתהליך העבודה.
שימוש בתוספים ל-Gemini CLI ב-Cloud SQL ל-MySQL
התוסף של Cloud SQL ל-Gemini CLI מבוסס על MCP Toolbox for Databases.
השילוב עם Gemini CLI מתבצע באמצעות תוסף ייעודי שמציע יכולות נוספות בהשוואה לחיבור הרגיל ל-Toolbox. התוסף מציע תהליך התקנה פשוט ומיומנויות שמבוססות על כלי MCP.
מידע נוסף זמין במאמרי העזרה של GitHub בנושא תוסף ל-Gemini CLI ל-Cloud SQL ל-MySQL.תוסף ל-Gemini CLI למסדי נתונים של Cloud SQL ל-MySQL
התוסףcloud-sql-mysql כולל מיומנויות לשליחת שאילתות למסד הנתונים ולמעקב אחרי התקינות שלו.
ב-GitHub מפורטת הרשימה המלאה של המיומנויות של Cloud SQL.
התוסף cloud-sql-mysql-observability מספק ממשק אחיד לניהול ולמעקב אחרי הביצועים והתקינות של מסד הנתונים ישירות מ-Gemini CLI.
| קטגוריה | כלים |
|---|---|
| ניראות (observability) |
|
תוסף ל-Gemini CLI למסדי נתונים של MySQL
רשימה של הפעולות האלה מופיעה במאמרים MCP Toolbox for Databases ותוסף ל-Gemini CLI ל-MySQL.
לפני שמתחילים
במסוף Google Cloud , בוחרים או יוצרים פרויקט ב- Google Cloud בדף לבחירת הפרויקט.
כברירת מחדל, Cloud SQL מקצה כתובת IP ציבורית למכונה חדשה. בהתאם לתרחיש לדוגמה, ודאו שהגדרתם כתובת IP ציבורית או כתובת IP פרטית למכונות Cloud SQL. Toolbox מתחבר בצורה מאובטחת באמצעות מחברי השפה של Cloud SQL.
מקצים את התפקידים הנדרשים בממשק ניהול הזהויות והרשאות הגישה (IAM) למשתמש שיפעיל את שרת ה-MCP. הכלים שזמינים תלויים בתפקידים שהוקצו:
משימה שם התפקיד התפקיד הנדרש ב-IAM הרשאת קריאה בלבד למשאבים, כולל הפעולות הבאות: get_instancelist_instanceslist_databaseswait_for_operation
צפייה ב-Cloud SQL roles/cloudsql.viewerהרשאת קריאה בלבד לנתוני מעקב, כמו מדדים של סדרות זמן. צפייה ב-Cloud Monitoring roles/monitoring.viewerהתפקיד הזה נותן הרשאות לניהול משאבים קיימים, כולל: - כל
viewerהכלים create_database
עריכה ב-Cloud SQL roles/cloudsql.editorהתפקיד הזה נותן שליטה מלאה על כל המשאבים, כולל: - כל הכלים של
viewerו-editor create_instancecreate_user
אדמין ב-Cloud SQL roles/cloudsql.adminמגדירים את Application Default Credentials (ADC) בסביבה שלכם.
יוצרים משתמש במסד הנתונים או משתמשים במשתמש קיים, ומכינים את שם המשתמש והסיסמה.
קישור באמצעות Data Agent Kit
התוסף Google Cloud Data Agent Kit מאפשר להתחבר ל-Cloud SQL ולשלוח אליו שאילתות מ-Visual Studio Code או מכל IDE שמבוסס על VS Code. הוא מאפשר להתחבר לשרתי MCP, לשלוח שאילתות לנתונים ולהריץ עומסי עבודה של הנדסת נתונים מתוך ה-IDE. ב-Data Agent Kit יש גם פלאגינים של CLI.
מידע נוסף זמין במאמר סקירה כללית על Data Agent Kit.
חיבור ל-Antigravity
אתם יכולים לקשר את Cloud SQL ל-MySQL ל-Antigravity בדרכים הבאות:
- שימוש במאגר MCP
- שימוש בהגדרות אישיות
מאגר MCP
השיטה הכי מומלצת להתחברות ל-Cloud SQL ל-MySQL ב-Antigravity היא להשתמש במאגר ה-MCP המובנה.
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל האפשרויות הנוספות (3 נקודות) בחלק העליון של החלונית ובוחרים באפשרות שרתי MCP.
- מאתרים את Cloud SQL ל-MySQL ברשימת השרתים הזמינים ולוחצים על Install.
- פועלים לפי ההנחיות במסך כדי לקשר את החשבונות באופן מאובטח, אם רלוונטי.
אחרי שמתקינים את Cloud SQL ל-MySQL במאגר MCP, המשאבים והכלים מהשרת זמינים באופן אוטומטי בכלי העריכה.
הגדרות אישיות
כדי להתחבר לשרת MCP מותאם אישית:
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל האפשרויות הנוספות (3 נקודות) בחלק העליון של החלונית ובוחרים באפשרות שרתי MCP.
- לוחצים על ניהול שרתי MCP > הצגת ההגדרות הגולמיות כדי לפתוח את הקובץ
mcp_config.json. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
"mcpServers": {
"cloud-sql-mysql": {
"command": "npx",
"args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mysql","--stdio"],
"env": {
"CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID",
"CLOUD_SQL_MYSQL_REGION": "REGION",
"CLOUD_SQL_MYSQL_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_MYSQL_USER": "USER_ID",
"CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD"
}
}
}
}
אחרי שמגדירים את שרת ה-MCP בהתאמה אישית, המשאבים והכלים מ-Cloud SQL ל-MySQL זמינים לעורך.
התקנת MCP Toolbox
- מורידים את הקובץ הבינארי שתואם למערכת ההפעלה ולארכיטקטורת המעבד (CPU).
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox
darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox
darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox
- הופכים את הקובץ הבינארי לקובץ הפעלה:
chmod +x toolbox
- מאמתים את ההתקנה באמצעות הפקודה הבאה:
./toolbox --version
הגדרת לקוח ה-MCP
בקטע הזה מוסבר איך להגדיר כלים שונים למפתחים כדי להתחבר למכונה של Cloud SQL באמצעות Toolbox. Toolbox פועל כשרת Model Context Protocol (MCP) בקוד פתוח שנמצא בין ה-IDE למסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלי ה-AI. כדי לראות את הוראות ההגדרה, בוחרים את הכרטיסייה של הכלי הספציפי.
Gemini CLI ל-Cloud SQL ל-MySQL
- מתקינים את Gemini CLI.
- מתקינים את התוסף Cloud SQL ל-MySQL ל-Gemini CLI מהמאגר ב-GitHub באמצעות הפקודה הבאה:
בזמן התקנת התוסף, מחליפים את הערכים הבאים:gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql
מחליפים את הערכים הבאים:export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MYSQL_REGION="REGION" export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME: מזהה הפרויקט ב- Google Cloud .
- REGION: האזור של המכונה ב-Cloud SQL.
- INSTANCE_NAME: המזהה של מכונת Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש של מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות ב-IAM.
- PASSWORD: אופציונלי: הסיסמה של המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות ב-IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, למשל "Public" (ברירת המחדל) או "Private".
- מפעילים את Gemini CLI במצב אינטראקטיבי:
gemini
CLI טוען באופן אוטומטי את התוסף ל-Gemini CLI ל-Cloud SQL ואת הכלים שלו, שבהם אתם יכולים להשתמש כדי לקיים אינטראקציה עם מסד הנתונים.
ב-Gemini CLI, משתמשים בפקודה
/extensionsכדי לוודא שהתוסף מותקן, ובפקודה/mcp listכדי לראות את הכלים.
Gemini CLI ל-MySQL
- מתקינים את Gemini CLI.
- מתקינים את תוסף התוכנה של MySQL ל-Gemini CLI מהמאגר ב-GitHub באמצעות הפקודה הבאה:
בזמן התקנת התוסף, מחליפים את הערכים הבאים:gemini extensions install https://github.com/gemini-cli-extensions/mysql
מחליפים את הערכים הבאים:export MYSQL_HOST="HOST" export MYSQL_PORT="PORT" export MYSQL_DATABASE="DATABASE" export MYSQL_USER="USER" export MYSQL_PASSWORD="PASSWORD" export MYSQL_QUERY_PARAMETERS="QUERY_PARAMETERS"
- HOST: שם המארח או כתובת ה-IP של שרת MySQL.
- PORT: מספר היציאה של שרת MySQL.
- DATABASE: השם של מסד הנתונים שאליו רוצים להתחבר.
- USER: שם המשתמש של מסד הנתונים.
- PASSWORD: הסיסמה של המשתמש במסד הנתונים.
- QUERY_PARAMETERS: אופציונלי: השאילתה הגולמית שצריך להוסיף למחרוזת החיבור של
db.
- מפעילים את Gemini CLI במצב אינטראקטיבי:
gemini
CLI טוען באופן אוטומטי את התוסף ל-Gemini CLI ל-MySQL ואת הכלים שלו, שבהם אתם יכולים להשתמש כדי לקיים אינטראקציה עם מסד הנתונים.
Gemini Code Assist
- מתקינים את התוסף Gemini Code Assist ב-Visual Studio Code.
- מפעילים את מצב Agent בצ'אט של Gemini Code Assist.
- בספריית העבודה, יוצרים תיקייה בשם
.gemini. בתוך התיקייה, יוצרים קובץsettings.json. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }
Claude Code
- מתקינים את Claude Code.
- מגדירים משתני סביבה כדי להתחבר למכונה של Cloud SQL:
מחליפים את הערכים הבאים:export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MYSQL_REGION="REGION" export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME: מזהה הפרויקט ב- Google Cloud .
- REGION: האזור של המכונה ב-Cloud SQL.
- INSTANCE_NAME: המזהה של מכונת Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש של מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות ב-IAM.
- PASSWORD: אופציונלי: הסיסמה של המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות ב-IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, למשל "Public" (ברירת המחדל) או "Private".
- מפעילים את הסוכן:
claude
- מתקינים את הפלאגין:
/plugin install cloud-sql-mysql@claude-plugins-official
Claude במחשב
- פותחים את Claude Desktop ועוברים אל הגדרות.
- בכרטיסייה Developer (מפתח), לוחצים על Edit Config (עריכת ההגדרות) כדי לפתוח את קובץ התצורה.
- מוסיפים את הקוד הבא כדי להתחבר לשרת ה-MCP ולהגדיר את משתני הסביבה:
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } } - מפעילים מחדש את Claude Desktop. במסך הצ'אט החדש מופיע סמל ה-MCP עם שרת ה-MCP החדש שזמין.
Codex
- מתקינים את Data Cloud Plugins Marketplace:
codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
- מתקינים את הפלאגין:
codex plugin install cloud-sql-mysql@data-cloud-plugins
- מגדירים את משתני הסביבה כדי להתחבר למכונה של Cloud SQL:
מחליפים את הערכים הבאים:export CLOUD_SQL_MYSQL_PROJECT="PROJECT_NAME" export CLOUD_SQL_MYSQL_REGION="REGION" export CLOUD_SQL_MYSQL_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_MYSQL_DATABASE="DATABASE_NAME" export CLOUD_SQL_MYSQL_USER="DATABASE_USER_NAME" export CLOUD_SQL_MYSQL_PASSWORD="PASSWORD" export CLOUD_SQL_MYSQL_IP_TYPE="IP_TYPE"
- PROJECT_NAME: מזהה הפרויקט ב- Google Cloud .
- REGION: האזור של המכונה ב-Cloud SQL.
- INSTANCE_NAME: המזהה של מכונת Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש של מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות ב-IAM.
- PASSWORD: אופציונלי: הסיסמה של המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות ב-IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, למשל "Public" (ברירת המחדל) או "Private".
- זה שינוי אופציונלי. עדכון זירת המסחר:
codex plugin marketplace upgrade data-agent-plugins
- מריצים את
codex plugin listאו משתמשים בתפריט האינטראקטיביpluginsכדי לאמת את הפלאגינים המותקנים.
Cline
- פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
- לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }
סמן
- אם הספרייה
.cursorלא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה. - יוצרים קובץ
.cursor/mcp.jsonאם הוא לא קיים ופותחים אותו. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } } - פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.
Visual Studio Code (Copilot)
- פותחים את VS Code ויוצרים את הספרייה
.vscodeבתיקיית הבסיס של הפרויקט, אם היא לא קיימת. - יוצרים את הקובץ
.vscode/mcp.jsonאם הוא לא קיים, ופותחים אותו. - מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "servers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }
גלישת רוח
- פותחים את Windsurf ועוברים אל Cascade assistant.
- לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
- מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{ "mcpServers": { "cloud-sql-mysql": { "command": "./PATH/TO/toolbox", "args": ["--prebuilt","cloud-sql-mysql","--stdio"], "env": { "CLOUD_SQL_MYSQL_PROJECT": "PROJECT_ID", "CLOUD_SQL_MYSQL_REGION": "REGION", "CLOUD_SQL_MYSQL_INSTANCE":"INSTANCE_ID", "CLOUD_SQL_MYSQL_DATABASE": "DATABASE_NAME", "CLOUD_SQL_MYSQL_USER": "USER_ID", "CLOUD_SQL_MYSQL_PASSWORD": "PASSWORD" } } } }