בדף הזה מוסבר איך לחבר את מופע 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 הוא ממשק שורת פקודה (CLI) מהדור הבא של Cloud de Confiance by S3NS, שמשלב את היכולות הבסיסיות ישירות בתוסף, וכך מפשט את ההגדרה וההגדרה. אתם יכולים להגדיר את 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.
לפני שמתחילים
בדף project selector במסוף Cloud de Confiance , בוחרים פרויקט ב- Cloud de Confiance by S3NS או יוצרים אותו.
כברירת מחדל, Cloud SQL מקצה כתובת IP ציבורית למופע חדש. בהתאם לתרחיש השימוש, צריך לוודא שמוגדרת כתובת IP ציבורית או כתובת IP פרטית למכונות Cloud SQL. החיבור של Toolbox מאובטח באמצעות Cloud SQL Language Connectors.
נותנים למשתמש שיפעיל את שרת ה-MCP את התפקידים הנדרשים בניהול הזהויות והרשאות הגישה (IAM). הכלים שזמינים לכם תלויים בתפקידים שהוקצו לכם:
משימה שם התפקיד תפקיד 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 Admin roles/cloudsql.adminמגדירים Application Default Credentials (ADC) לסביבה.
יוצרים או משתמשים מחדש במשתמש במסד נתונים, ומוודאים שיש לכם את שם המשתמש והסיסמה.
התחברות ל-Antigravity
אפשר לקשר את Cloud SQL ל-MySQL ל-Antigravity בדרכים הבאות:
- שימוש ב-MCP Store
- שימוש בהגדרה מותאמת אישית
חנות MCP
השיטה המומלצת ביותר להתחבר ל-Cloud SQL ל-MySQL ב-Antigravity היא באמצעות חנות ה-MCP המובנית.
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל שלוש הנקודות בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
- ברשימת השרתים הזמינים, מאתרים את Cloud SQL ל-MySQL ולוחצים על Install (התקנה).
- פועלים לפי ההוראות המוצגות כדי לקשר את החשבונות בצורה מאובטחת, אם רלוונטי.
אחרי שמתקינים את Cloud SQL ל-MySQL ב-MCP Store, המשאבים והכלים מהשרת זמינים באופן אוטומטי בכלי העריכה.
הגדרות אישיות
כדי להתחבר לשרת MCP בהתאמה אישית, פועלים לפי השלבים הבאים:
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל שלוש הנקודות בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
- לוחצים על Manage MCP Servers > View raw config (ניהול שרתי 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
<div>
<devsite-selector>
<section>
<h3 id="linux-amd64">linux/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/linux/amd64/toolbox</pre>
</section>
<section>
<h3 id="darwin-arm64">darwin/arm64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox</pre>
</section>
<section>
<h3 id="darwin-amd64">darwin/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/amd64/toolbox</pre>
</section>
<section>
<h3 id="windows-amd64">windows/amd64</h3>
<pre class="devsite-click-to-copy">curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox</pre>
</section>
</devsite-selector>
</div>
```bash
chmod +x toolbox
```
```bash
./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: מזהה הפרויקט ב- Cloud de Confiance .
- 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.
- מפעילים את מצב הסוכן בצ'אט של 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: מזהה הפרויקט ב- Cloud de Confiance .
- REGION: האזור של מופע Cloud SQL.
- INSTANCE_NAME: המזהה של מופע Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- PASSWORD: אופציונלי: הסיסמה של משתמש מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, למשל 'Public' (ברירת מחדל) או 'Private'.
- מפעילים את הסוכן:
claude - אפשר למצוא את גרסת ההפצה העדכנית ביותר במאגר המיומנויות של Cloud SQL ל-MySQL ולהוסיף את ה-Marketplace:
/plugin marketplace add https://github.com/gemini-cli-extensions/cloud-sql-mysql.git#VERSION - מתקינים את הפלאגין:
/plugin install cloud-sql-mysql@cloud-sql-mysql-marketplace
Claude למחשב
- פותחים את Claude למחשב ועוברים אל הגדרות.
- בכרטיסייה 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
- אפשר למצוא את גרסת ההפצה העדכנית במאגר המיומנויות של Cloud SQL ל-MySQL ולשכפל אותה:
git clone --branch VERSION git@github.com:gemini-cli-extensions/cloud-sql-mysql.git
- מתקינים את הפלאגין:
mkdir -p ~/.codex/plugins cp -R /absolute/path/to/cloud-sql-mysql ~/.codex/plugins/cloud-sql-mysql
- מגדירים את משתני הסביבה כדי להתחבר למכונת 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: מזהה הפרויקט ב- Cloud de Confiance .
- REGION: האזור של מופע Cloud SQL.
- INSTANCE_NAME: המזהה של מופע Cloud SQL.
- DATABASE_NAME: השם של מסד הנתונים שאליו רוצים להתחבר.
- DATABASE_USER_NAME: אופציונלי: שם המשתמש במסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- PASSWORD: אופציונלי: הסיסמה של משתמש מסד הנתונים. אם לא מציינים ערך, ברירת המחדל היא אימות IAM.
- IP_TYPE: אופציונלי: סוג ה-IP, למשל 'Public' (ברירת מחדל) או 'Private'.
- יוצרים או מעדכנים את הקובץ marketplace.json:
{ "name": "my-data-cloud-google-marketplace", "interface": { "displayName": "Google Data Cloud Skills" }, "plugins": [ { "name": "cloud-sql-mysql", "source": { "source": "local", "path": "./plugins/cloud-sql-mysql" }, "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" }, "category": "Database" } ] } - מריצים את הפקודה
codex plugin listאו משתמשים בתפריט האינטראקטיביpluginsכדי לאמת את הפלאגינים שהתקנתם.
קלין
- פותחים את התוסף Cline ב-VS Code ומקישים על הסמל MCP Servers.
- לוחצים על Configure 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 (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" } } } }