בדף הזה מוסבר איך לחבר את מכונת Cloud SQL לכלים שונים למפתחים שמבוססים על AI, כולל:
- Gemini Code Assist
- Claude code
- Claude למחשב
- Cline (תוסף ל-VS Code)
- Cursor
- Visual Studio Code (Copilot)
- Windsurf (Codeium)
- Antigravity
כדי ליהנות מחוויה משולבת, מומלץ להשתמש בתוסף ל-Gemini CLI הייעודי ל-Cloud SQL ל-PostgreSQL.
ממשק שורת הפקודה של 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 ל-PostgreSQL
התוסף ל-Gemini CLI ל-Cloud SQL מבוסס על MCP Toolbox for Databases. הכלי MCP Toolbox for Databases נמצא כרגע בגרסת בטא (לפני גרסה 1.0), ויכול להיות שיחולו בו שינויים שעלולים לשבור את התאימות עד לגרסה היציבה הראשונה (גרסה 1.0).
השילוב עם Gemini CLI מתבצע באמצעות תוסף ייעודי שמציע יכולות נוספות בהשוואה לחיבור הרגיל ל-Toolbox. התוסף מציע תהליך התקנה פשוט וסט כלים.
מידע נוסף זמין במאמרי העזרה של GitHub בנושא תוסף ל-Gemini CLI ל-Cloud SQL ל-PostgreSQL.תוסף ל-Gemini CLI למסדי נתונים של Cloud SQL ל-PostgreSQL
התוסףcloud-sql-postgresql כולל כלים לשליחת שאילתות למסד הנתונים, לניהול משאבי Cloud SQL ולמעקב אחרי תקינות מסד הנתונים.
| קטגוריה | כלים |
|---|---|
| פעולות במסד נתונים |
|
| ניהול משאבים עבור מופעים ומשתמשים |
|
| תקינות ותחזוקה של מסד נתונים |
|
התוסף cloud-sql-postgresql-observability מספק ממשק מאוחד לניהול ולמעקב אחר הביצועים והתקינות של מסד הנתונים ישירות מ-Gemini CLI.
| קטגוריה | כלים |
|---|---|
| ניראות (observability) |
|
תוסף ל-Gemini CLI למסדי נתונים של PostgreSQL
רשימה של הפעולות האלה זמינה במאמרים MCP Toolbox for Databases ו-תוסף ל-Gemini CLI עבור PostgreSQL.
לפני שמתחילים
בדף project selector במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.
כברירת מחדל, Cloud SQL מקצה כתובת IP ציבורית למופע חדש. בהתאם לתרחיש השימוש, צריך לוודא שמוגדרת כתובת IP ציבורית או כתובת IP פרטית למכונות Cloud SQL. החיבור של Toolbox מאובטח באמצעות מחברי שפה של Cloud SQL.
נותנים למשתמש שיפעיל את שרת ה-MCP את התפקידים הנדרשים בניהול הזהויות והרשאות הגישה (IAM). הכלים שזמינים תלויים בתפקידים שהוקצו:
משימה שם התפקיד תפקיד IAM נדרש התפקיד הזה מספק גישה לקריאה בלבד למשאבים, כולל הפעולות הבאות: get_instancelist_instanceslist_databaseswait_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_instancecreate_user
Cloud SQL Admin roles/cloudsql.adminמגדירים Application Default Credentials (ADC) לסביבה.
יוצרים או משתמשים מחדש במשתמש במסד נתונים, ומוודאים שיש לכם את שם המשתמש והסיסמה.
איך מתחברים ל-Antigravity
אפשר לקשר את Cloud SQL ל-PostgreSQL ל-Antigravity בדרכים הבאות:
- שימוש ב-MCP Store
- שימוש בהגדרה מותאמת אישית
MCP Store
השיטה המומלצת ביותר להתחברות ל-Cloud SQL ל-PostgreSQL ב-Antigravity היא באמצעות חנות MCP המובנית.
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל האפשרויות הנוספות '...' בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
- ברשימת השרתים הזמינים, מאתרים את Cloud SQL ל-PostgreSQL ולוחצים על התקנה.
- פועלים לפי ההוראות המוצגות כדי לקשר את החשבונות בצורה מאובטחת, אם רלוונטי.
אחרי שמתקינים את Cloud SQL ל-PostgreSQL בחנות של MCP, המשאבים והכלים מהשרת זמינים באופן אוטומטי בכלי העריכה.
הגדרות אישיות
כדי להתחבר לשרת MCP מותאם אישית, פועלים לפי השלבים הבאים:
- פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
- לוחצים על סמל האפשרויות הנוספות '...' בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
- לוחצים על Manage MCP Servers > View raw config (ניהול שרתי MCP > הצגת הגדרות גולמיות) כדי לפתוח את הקובץ
mcp_config.json. - מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "npx",
"args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
אחרי שמגדירים את שרת ה-MCP המותאם אישית, המשאבים והכלים משרת Cloud SQL ל-PostgreSQL זמינים לעורך.
התקנת 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 ל-PostgreSQL
- מתקינים את Gemini CLI.
- מתקינים את התוסף Cloud SQL ל-PostgreSQL ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:
gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgresql
- מגדירים משתני סביבה כדי להתחבר למופע Cloud SQL:
מחליפים את מה שכתוב בשדות הבאים:export CLOUD_SQL_POSTGRES_PROJECT="PROJECT_NAME" export CLOUD_SQL_POSTGRES_REGION="REGION" export CLOUD_SQL_POSTGRES_INSTANCE="INSTANCE_NAME" export CLOUD_SQL_POSTGRES_DATABASE="DATABASE_NAME" export CLOUD_SQL_POSTGRES_USER="DATABASE_USER_NAME" export CLOUD_SQL_POSTGRES_PASSWORD="PASSWORD" export CLOUD_SQL_POSTGRES_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 ל-PostgreSQL
1. מתקינים את Gemini CLI.
2. מתקינים את תוסף התוכנה של PostgreSQL ל-Gemini CLI ממאגר GitHub באמצעות הפקודה הבאה:
gemini extensions install https://github.com/gemini-cli-extensions/postgres
export POSTGRES_HOST="HOST"
export POSTGRES_PORT="PORT"
export POSTGRES_DATABASE="DATABASE"
export POSTGRES_USER="USER"
export POSTGRES_PASSWORD="PASSWORD"
export POSTGRES_QUERY_PARAMETERS="QUERY_PARAMETERS"
- HOST: שם המארח או כתובת ה-IP של שרת PostgreSQL.
- PORT: מספר היציאה של שרת PostgreSQL.
- DATABASE: השם של מסד הנתונים שאליו רוצים להתחבר.
- USER: שם המשתמש במסד הנתונים.
- PASSWORD: הסיסמה של משתמש מסד הנתונים.
- QUERY_PARAMETERS: אופציונלי: השאילתה הגולמית שרוצים להוסיף למחרוזת הקישור של
db.
gemini
ממשק ה-CLI טוען באופן אוטומטי את התוסף ל-Gemini CLI for PostgreSQL ואת הכלים שלו, שבהם אפשר להשתמש כדי ליצור אינטראקציה עם מסד הנתונים.
Gemini Code Assist
1. מתקינים את התוסף Gemini Code Assist ב-Visual Studio Code.
2. הפעלת מצב סוכן בצ'אט של Gemini Code Assist.
3. בספריית העבודה, יוצרים תיקייה בשם
.gemini. בתוך התיקייה, יוצרים קובץ settings.json.4. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
Claude code
1. מתקינים את Claude Code.
2. יוצרים קובץ
.mcp.json בתיקיית הבסיס של הפרויקט אם הוא לא קיים. 3. מוסיפים הגדרה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
Claude למחשב
1. פותחים את Claude למחשב ועוברים להגדרות.
2. בכרטיסייה 'פיתוח', מקישים על 'עריכת התצורה' כדי לפתוח את קובץ התצורה.
3. מוסיפים הגדרה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
5. מפעילים מחדש את Claude Desktop.
6. במסך הצ'אט החדש מוצג סמל של פטיש (MCP) עם שרת ה-MCP החדש שזמין.
Cline
1. פותחים את התוסף Cline ב-VS Code ומקישים על הסמל MCP Servers.
2. מקישים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ התצורה.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
4. אחרי שהשרת מתחבר בהצלחה, מופיע סטטוס פעיל בצבע ירוק.
סמן
1. אם היא לא קיימת, יוצרים את הספרייה
.cursor בתיקיית הבסיס של הפרויקט. 2. יוצרים קובץ
.cursor/mcp.json אם הוא לא קיים ופותחים אותו.3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
4. פותחים את הסמן ועוברים אל הגדרות > הגדרות הסמן > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.
קוד Visual Studio (Copilot)
1. פותחים את VS Code ויוצרים את הספרייה
.vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת. 2. יוצרים קובץ
.vscode/mcp.json אם הוא לא קיים, ופותחים אותו. 3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"servers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}
גלישת רוח
1. פותחים את Windsurf ועוברים אל Cascade assistant.
2. מקישים על סמל MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים:
{
"mcpServers": {
"cloud-sql-postgres": {
"command": "./PATH/TO/toolbox",
"args": ["--prebuilt","cloud-sql-postgres","--stdio"],
"env": {
"CLOUD_SQL_POSTGRES_PROJECT": "PROJECT_ID",
"CLOUD_SQL_POSTGRES_REGION": "REGION",
"CLOUD_SQL_POSTGRES_INSTANCE": "INSTANCE_ID",
"CLOUD_SQL_POSTGRES_DATABASE": "DATABASE_NAME",
"CLOUD_SQL_POSTGRES_USER": "USER_ID",
"CLOUD_SQL_POSTGRES_PASSWORD": "PASSWORD"
}
}
}
}