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

‫MySQL | PostgreSQL | SQL Server

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

תוסף ל-Gemini CLI ל-Cloud SQL ל-SQL Server
תוסף ל-Gemini CLI ל-SQL Server

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

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

ממשק שורת הפקודה של 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 ל-SQL Server

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

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

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

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

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

קטגוריה כלים

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

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

‫list_tables: מציג רשימה של כל הטבלאות והתיאורים שלהן שנמצאו במסד נתונים.
‫execute_sql: מריץ כל הצהרת SQL.

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

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

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

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

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

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

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

בדף 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 ל-SQL Server ל-Antigravity בדרכים הבאות:

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

MCP Store

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

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

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

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

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

פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
לוחצים על סמל האפשרויות הנוספות '...' בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
לוחצים על Manage MCP Servers > View raw config (ניהול שרתי MCP > הצגת הגדרות גולמיות) כדי לפתוח את הקובץ mcp_config.json.
מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.

{
  "mcpServers": {
    "cloud-sql-mssql": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
          "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
          "CLOUD_SQL_MSSQL_REGION": "REGION",
          "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
          "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
          "CLOUD_SQL_MSSQL_USER": "USER_ID",
          "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

אחרי שמגדירים את שרת ה-MCP המותאם אישית, המשאבים והכלים מהשרת של Cloud SQL ל-SQL Server זמינים בכלי העריכה.

התקנת 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 ל-SQL Server

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

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

‫3. מגדירים משתני סביבה כדי להתחבר למופע Cloud SQL:

      export CLOUD_SQL_MSSQL_PROJECT="PROJECT_NAME"
      export CLOUD_SQL_MSSQL_REGION="REGION"
      export CLOUD_SQL_MSSQL_INSTANCE="INSTANCE_NAME"
      export CLOUD_SQL_MSSQL_DATABASE="DATABASE_NAME"
      export CLOUD_SQL_MSSQL_USER="DATABASE_USER_NAME"
      export CLOUD_SQL_MSSQL_PASSWORD="PASSWORD"
      export CLOUD_SQL_MSSQL_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, למשל 'ציבורי' (ברירת מחדל) או 'פרטי'.

‫4. מפעילים את Gemini CLI במצב אינטראקטיבי:

      gemini

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

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

‫Gemini CLI ל-SQL Server

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

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

‫3. מגדירים משתני סביבה כדי להתחבר למכונה של SQL Server:

      export MSSQL_HOST="HOST"
      export MSSQL_PORT="PORT"
      export MSSQL_DATABASE="DATABASE"
      export MSSQL_USER="USER"
      export MSSQL_PASSWORD="PASSWORD"

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

‫HOST: שם המארח או כתובת ה-IP של שרת SQL Server.
‫PORT: מספר היציאה של שרת SQL Server.
‫DATABASE: השם של מסד הנתונים שאליו רוצים להתחבר.
‫USER: שם המשתמש במסד הנתונים.
‫PASSWORD: הסיסמה של משתמש מסד הנתונים.

‫4. מפעילים את Gemini CLI במצב אינטראקטיבי:

      gemini

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

Gemini Code Assist

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

Claude code

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

‫Claude למחשב

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

Cline

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

סמן

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

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

קוד Visual Studio ‏ (Copilot)

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


{
  "servers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}

גלישת רוח

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


{
  "mcpServers": {
    "cloud-sql-sqlserver": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","cloud-sql-mssql","--stdio"],
      "env": {
        "CLOUD_SQL_MSSQL_PROJECT": "PROJECT_ID",
        "CLOUD_SQL_MSSQL_REGION": "REGION",
        "CLOUD_SQL_MSSQL_INSTANCE": "INSTANCE_ID",
        "CLOUD_SQL_MSSQL_DATABASE": "DATABASE_NAME",
        "CLOUD_SQL_MSSQL_IP_ADDRESS": "IP_ADDRESS",
        "CLOUD_SQL_MSSQL_USER": "USER_ID",
        "CLOUD_SQL_MSSQL_PASSWORD": "PASSWORD"
      }
    }
  }
}