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

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

כדי ליהנות מחוויה משולבת, מומלץ להשתמש בתוסף הייעודי של 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)
  • get_system_metrics: אחזור מדדי מערכת של מכונה ב-Cloud SQL.
  • <!--: Retrieves query-related metrics for a Cloud SQL instance. -->get_query_metrics: אחזור מדדים שקשורים לשאילתות במכונה של Cloud SQL.

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

רשימה של הפעולות האלה מופיעה במאמרים MCP Toolbox for Databases ותוסף ל-Gemini CLI ל-MySQL.

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

קישור באמצעות 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 המובנה.

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

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

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

כדי להתחבר לשרת MCP מותאם אישית:

  1. פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
  2. לוחצים על סמל האפשרויות הנוספות (3 נקודות) בחלק העליון של החלונית ובוחרים באפשרות שרתי MCP.
  3. לוחצים על ניהול שרתי MCP‏ > הצגת ההגדרות הגולמיות כדי לפתוח את הקובץ mcp_config.json.
  4. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "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

  1. מורידים את הקובץ הבינארי שתואם למערכת ההפעלה ולארכיטקטורת המעבד (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
  2. הופכים את הקובץ הבינארי לקובץ הפעלה:
    chmod +x toolbox
  3. מאמתים את ההתקנה באמצעות הפקודה הבאה:
    ./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
    
    בזמן התקנת התוסף, מחליפים את הערכים הבאים:
    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".
  3. מפעילים את 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
    בזמן התקנת התוסף, מחליפים את הערכים הבאים:
    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.
  3. מפעילים את Gemini CLI במצב אינטראקטיבי:
    gemini

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

Gemini Code Assist


  1. מתקינים את התוסף Gemini Code Assist ב-Visual Studio Code.
  2. מפעילים את מצב Agent בצ'אט של 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. מגדירים משתני סביבה כדי להתחבר למכונה של 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".
  3. מפעילים את הסוכן:
    claude
  4. מתקינים את הפלאגין:
    /plugin install cloud-sql-mysql@claude-plugins-official

Claude במחשב


  1. פותחים את Claude Desktop ועוברים אל הגדרות.
  2. בכרטיסייה Developer (מפתח), לוחצים על Edit Config (עריכת ההגדרות) כדי לפתוח את קובץ התצורה.
  3. מוסיפים את הקוד הבא כדי להתחבר לשרת ה-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"
          }
        }
      }
    }
    
  4. מפעילים מחדש את Claude Desktop. במסך הצ'אט החדש מופיע סמל ה-MCP עם שרת ה-MCP החדש שזמין.

Codex


  1. מתקינים את Data Cloud Plugins Marketplace:
    codex plugin marketplace add GoogleCloudPlatform/data-cloud-plugins
  2. מתקינים את הפלאגין:
    codex plugin install cloud-sql-mysql@data-cloud-plugins
  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. זה שינוי אופציונלי. עדכון זירת המסחר:
    codex plugin marketplace upgrade data-agent-plugins
  5. מריצים את codex plugin list או משתמשים בתפריט האינטראקטיבי plugins כדי לאמת את הפלאגינים המותקנים.

Cline


  1. פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
  2. לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
    {
      "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"
          }
        }
      }
    }
    
    אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.

סמן


  1. אם הספרייה .cursor לא קיימת בתיקיית הבסיס של הפרויקט, יוצרים אותה.
  2. יוצרים קובץ .cursor/mcp.json אם הוא לא קיים ופותחים אותו.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
    {
      "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"
          }
        }
      }
    }
    
  4. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.

‫Visual Studio Code ‏(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. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
    {
      "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"
          }
        }
      }
    }