שימוש ב-Cloud SQL ל-MySQL עם MCP,‏ Gemini CLI וסוכנים אחרים (original) (raw)

בדף הזה מוסבר איך לחבר את מכונת Cloud SQL לכלים שונים למפתחים שמבוססים על AI, כולל:

תוסף ל-Gemini CLI ל-Cloud SQL ל-MySQL
תוסף ל-Gemini CLI ל-MySQL
Gemini Code Assist
Claude code
Claude למחשב
‫Cline (תוסף ל-VS Code)
Cursor
‫Visual Studio Code (Copilot)
‫Windsurf (Codeium)
Antigravity

כדי ליהנות מחוויה משולבת, מומלץ להשתמש בתוסף ל-Gemini CLI ייעודי ל-Cloud SQL ל-MySQL.

ממשק שורת הפקודה של Gemini (Gemini CLI) הוא ממשק שורת הפקודה מהדור הבא של As Google Cloud. הוא כולל את שרת ה-MCP הבסיסי ישירות בתוסף, מה שמפשט את ההגדרה והקביעה של ההגדרות. אתם יכולים להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI, וליהנות מיתרונות דומים בהגדרה בסביבת הפיתוח המשולבת (IDE).

בכלי פיתוח אחרים שתומכים בModel Context Protocol‏ (MCP), אפשר להתחבר באמצעות הגדרה ידנית של MCP Toolbox for Databases (Toolbox). ‫Toolbox הוא שרת MCP בקוד פתוח שמחבר סוכני AI לנתונים שלכם באמצעות ניהול משימות כמו אימות ואיגום חיבורים. כך תוכלו לקיים אינטראקציה עם הנתונים באמצעות שפה טבעית ישירות מ-IDE. בכלים האלה, השיטה הזו מספקת יכולות בסיסיות של אינטראקציה עם מסד הנתונים.

מידע נוסף זמין במאמרים כלים מוכנים מראש ו-MCP Toolbox for Databases on GitHub.

מידע על Gemini CLI ותוספים

‫Gemini CLI הוא סוכן AI בקוד פתוח שנועד לעזור בתהליכי פיתוח, למשל בכתיבת קוד, בניפוי באגים, בחיפוש נתונים וביצירת תוכן. הוא מספק ממשק מבוסס-סוכן לאינטראקציה עם שירותי ניתוח נתונים ומסדי נתונים פופולריים בקוד פתוח.

איך תוספים פועלים

‫Gemini CLI הוא כלי שניתן להרחבה, ומאפשר להוסיף כלים ויכולות חדשים באמצעות תוספים. אפשר לטעון את התוספים מכתובת URL ב-GitHub, מספרייה מקומית או ממאגר שניתן להגדרה. הם מספקים כלים חדשים, פקודות סלאש והנחיות שיעזרו לכם בתהליך העבודה.

שימוש בתוספים ל-Gemini CLI ב-Cloud SQL ל-MySQL

התוסף ל-Gemini CLI ל-Cloud SQL מבוסס על MCP Toolbox for Databases. הכלי MCP Toolbox for Databases נמצא כרגע בגרסת בטא (לפני גרסה 1.0), ויכול להיות שיחולו בו שינויים שעלולים לשבור את התאימות עד לגרסה היציבה הראשונה (גרסה 1.0).

השילוב עם Gemini CLI מתבצע באמצעות תוסף ייעודי שמציע יכולות נוספות בהשוואה לחיבור הרגיל ל-Toolbox. התוסף מציע תהליך התקנה פשוט וסט כלים.

מידע נוסף זמין במאמרי העזרה של GitHub בנושא תוסף ל-Gemini CLI ל-Cloud SQL ל-MySQL.

תוסף ל-Gemini CLI למסדי נתונים של Cloud SQL ל-MySQL

התוסף cloud-sql-mysql כולל כלים לשליחת שאילתות למסד הנתונים ולמעקב אחרי תקינות מסד הנתונים.

קטגוריה	כלים
פעולות במסד נתונים	‫list_tables: מציג רשימה של כל הטבלאות והתיאורים שלהן שנמצאו במסד נתונים. ‫execute_sql: מריץ כל הצהרת SQL. ‫list_active_queries: מציג רשימה של שאילתות שמופעלות כרגע במופע Cloud SQL. ‫list_tables_missing_unique_indexes: מוצא טבלאות ללא מפתחות ראשיים או ייחודיים. ‫list_table_fragmentation: מקבל מידע על פיצול טבלה. ‫get_query_plan: מקבל את תוכנית השאילתה עבור הצהרה יחידה ממופע Cloud SQL.
ניהול משאבים עבור מופעים ומשתמשים	‫create_user: יוצר משתמש חדש במופע Cloud SQL. ‫list_databases: מציג רשימה של כל מסדי הנתונים במופע Cloud SQL. ‫create_database: יצירת מסד נתונים חדש במופע Cloud SQL. ‫list_instances: מציג רשימה של מופעי Cloud SQL בפרויקט נתון. ‫get_instance: קבלת הפרטים על מופע ספציפי של Cloud SQL. ‫create_instance: יוצר מופע חדש של Cloud SQL. ‫wait_for_operation: שולח בקשות חוזרות ל-API של פעולות עד שהפעולה מסתיימת.

קטגוריה

כלים

פעולות במסד נתונים

‫list_tables: מציג רשימה של כל הטבלאות והתיאורים שלהן שנמצאו במסד נתונים. ‫execute_sql: מריץ כל הצהרת SQL. ‫list_active_queries: מציג רשימה של שאילתות שמופעלות כרגע במופע Cloud SQL. ‫list_tables_missing_unique_indexes: מוצא טבלאות ללא מפתחות ראשיים או ייחודיים. ‫list_table_fragmentation: מקבל מידע על פיצול טבלה. ‫get_query_plan: מקבל את תוכנית השאילתה עבור הצהרה יחידה ממופע Cloud SQL.

ניהול משאבים עבור מופעים ומשתמשים

‫create_user: יוצר משתמש חדש במופע Cloud SQL. ‫list_databases: מציג רשימה של כל מסדי הנתונים במופע Cloud SQL. ‫create_database: יצירת מסד נתונים חדש במופע Cloud SQL. ‫list_instances: מציג רשימה של מופעי Cloud SQL בפרויקט נתון. ‫get_instance: קבלת הפרטים על מופע ספציפי של Cloud SQL. ‫create_instance: יוצר מופע חדש של Cloud SQL. ‫wait_for_operation: שולח בקשות חוזרות ל-API של פעולות עד שהפעולה מסתיימת.

התוסף cloud-sql-mysql-observability מספק ממשק מאוחד לניהול ולמעקב אחר הביצועים והתקינות של מסד הנתונים ישירות מ-Gemini CLI.

קטגוריה	כלים
ניראות (observability)	‫get_system_metrics: אחזור מדדים של מערכת עבור מופע Cloud SQL. ‫get_query_metrics: אחזור מדדים שקשורים לשאילתות עבור מופע Cloud SQL.

תוסף ל-Gemini CLI למסדי נתונים של MySQL

רשימה של הפעולות האלה זמינה במאמרים MCP Toolbox for Databases (ערכת הכלים MCP למסדי נתונים) ו-Gemini CLI extension for MySQL (תוסף ל-Gemini CLI ל-MySQL).

לפני שמתחילים

בדף project selector במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
מוודאים שהחיוב מופעל בפרויקט Google Cloud .
מפעילים את Cloud SQL Admin API ב Google Cloud פרויקט.
כברירת מחדל, Cloud SQL מקצה כתובת IP ציבורית למופע חדש. בהתאם לתרחיש השימוש, צריך לוודא שמוגדרת כתובת IP ציבורית או כתובת IP פרטית למכונות Cloud SQL. החיבור של Toolbox מאובטח באמצעות מחברי שפה של Cloud SQL.

נותנים למשתמש שיפעיל את שרת ה-MCP את התפקידים הנדרשים בניהול הזהויות והרשאות הגישה (IAM). הכלים שזמינים תלויים בתפקידים שהוקצו:

משימה	שם התפקיד	תפקיד IAM נדרש
התפקיד הזה מספק גישה לקריאה בלבד למשאבים, כולל הפעולות הבאות: get_instance list_instances list_databases wait_for_operation	Cloud SQL Viewer	roles/cloudsql.viewer
ההרשאה מאפשרת גישת קריאה בלבד לנתוני מעקב, כמו מדדים של סדרות זמן.	בעל הרשאת צפייה ב-Cloud Monitoring	roles/monitoring.viewer
ההרשאות שמוקצות לתפקיד הזה מאפשרות לנהל משאבים קיימים, כולל הפעולות הבאות: כל הכלים של viewer create_database	Cloud SQL Editor	roles/cloudsql.editor
התפקיד הזה נותן שליטה מלאה על כל המשאבים, כולל המשאבים הבאים: כל הכלים של viewer ושל editor create_instance create_user	Cloud SQL Admin	roles/cloudsql.admin

מגדירים Application Default Credentials (ADC) לסביבה.
יוצרים או משתמשים מחדש במשתמש במסד נתונים, ומוודאים שיש לכם את שם המשתמש והסיסמה.

איך מתחברים ל-Antigravity

אפשר לחבר את Cloud SQL ל-MySQL ל-Antigravity בדרכים הבאות:

שימוש ב-MCP Store
שימוש בהגדרה מותאמת אישית

MCP Store

השיטה המומלצת ביותר להתחבר ל-Cloud SQL ל-MySQL ב-Antigravity היא באמצעות חנות MCP המובנית.

פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
לוחצים על סמל האפשרויות הנוספות '...' בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
ברשימת השרתים הזמינים, מאתרים את Cloud SQL ל-MySQL ולוחצים על Install (התקנה).
פועלים לפי ההוראות המוצגות כדי לקשר את החשבונות בצורה מאובטחת, אם רלוונטי.

אחרי שמתקינים את Cloud SQL ל-MySQL בחנות של MCP, המשאבים והכלים מהשרת זמינים באופן אוטומטי בכלי העריכה.

הגדרות אישיות

כדי להתחבר לשרת 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 זמינים לעורך.

כדי להתקין את ערכת הכלים, מורידים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU שלכם.

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.7.0/windows/amd64/toolbox 2. הופכים את הקובץ הבינארי לקובץ הפעלה:

chmod +x toolbox

כדי לוודא שההתקנה בוצעה, מריצים את הפקודה הבאה:

./toolbox --version

הגדרת לקוח MCP

בקטע הזה מוסבר איך להגדיר כלי פיתוח שונים כדי להתחבר למופע Cloud SQL באמצעות Toolbox. ‫Toolbox הוא שרת Model Context Protocol‏ (MCP) בקוד פתוח שפועל בין סביבת הפיתוח המשולבת (IDE) לבין מסד הנתונים, ומספק מישור בקרה מאובטח ויעיל לכלי ה-AI שלכם. בוחרים את הכרטיסייה של הכלי הספציפי כדי לראות את הוראות ההגדרה.

‫Gemini CLI ל-Cloud SQL ל-MySQL

‫1. מתקינים את Gemini CLI.
2. מתקינים את התוסף Cloud SQL ל-MySQL ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:

gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-mysql

‫3. מגדירים משתני סביבה כדי להתחבר למופע 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'. ‫4. מפעילים את Gemini CLI במצב אינטראקטיבי:
```
gemini
```

ה-CLI טוען באופן אוטומטי את התוסף ל-Gemini CLI ל-Cloud SQL ואת הכלים שלו, שבעזרתם אפשר ליצור אינטראקציה עם מסד הנתונים.

ב-Gemini CLI, משתמשים בפקודה /extensions כדי לוודא שהתוסף מותקן, ובפקודה /mcp list כדי לראות את הכלים.

‫Gemini CLI ל-MySQL

1. מתקינים את Gemini CLI.
2. כדי להתקין את תוסף התוכנה MySQL ל-Gemini CLI ממאגר GitHub, מריצים את הפקודה הבאה:

  gemini extensions install https://github.com/gemini-cli-extensions/mysql

‫3. מגדירים משתני סביבה כדי להתחבר למכונת 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. ‫4. מפעילים את Gemini CLI במצב אינטראקטיבי:
```
gemini
```

ממשק ה-CLI טוען באופן אוטומטי את התוסף ל-Gemini CLI עבור MySQL ואת הכלים שלו, שבהם אפשר להשתמש כדי ליצור אינטראקציה עם מסד הנתונים.

Gemini Code Assist

1. מתקינים את התוסף Gemini Code Assist ב-Visual Studio Code.
2. הפעלת מצב סוכן בצ'אט של Gemini Code Assist.
‫3. בספריית העבודה, יוצרים תיקייה בשם .gemini. בתוך התיקייה, יוצרים קובץ settings.json.
4. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:

{ "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

1. מתקינים את Claude Code.
2. יוצרים קובץ .mcp.json בתיקיית הבסיס של הפרויקט אם הוא לא קיים.
‫3. מוסיפים הגדרה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:

‫Claude למחשב

1. פותחים את Claude למחשב ועוברים להגדרות.
2. בכרטיסייה 'פיתוח', מקישים על 'עריכת התצורה' כדי לפתוח את קובץ התצורה.
‫3. מוסיפים הגדרה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:

‫5. מפעילים מחדש את Claude Desktop.
‫6. במסך הצ'אט החדש מוצג סמל של פטיש (MCP) עם שרת ה-MCP החדש שזמין.

Cline

1. פותחים את התוסף Cline ב-VS Code ומקישים על הסמל MCP Servers.
2. מקישים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ התצורה.
‫3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:

4. אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.

סמן

1. אם היא לא קיימת, יוצרים את הספרייה .cursor בתיקיית הבסיס של הפרויקט.
2. יוצרים קובץ .cursor/mcp.json אם הוא לא קיים ופותחים אותו.
‫3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:

4. פותחים את הסמן ועוברים אל הגדרות > הגדרות הסמן > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קוד Visual Studio ‏ (Copilot)

1. פותחים את VS Code ויוצרים את הספרייה .vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
2. יוצרים קובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
‫3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:

{ "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" } } } }

גלישת רוח

1. פותחים את Windsurf ועוברים אל Cascade assistant.
2. מקישים על סמל MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
‫3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים: