שימוש ב-AlloyDB Omni עם MCP, ‏Gemini CLI וסוכנים אחרים

בחירת גרסת תיעוד:

במסמך הזה מוסבר איך לחבר את המכונה של AlloyDB Omni לסוכנים שונים שתומכים ב-Model Context Protocol‏ (MCP).

מכיוון ש-AlloyDB Omni תואם ל-PostgreSQL, אתם יכולים להשתמש בכלים ובתוספים שמיועדים ל-PostgreSQL.

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

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

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

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

  1. התקנת AlloyDB Omni ל-Linux ולהפעיל מכונה של מסד נתונים.
  2. יוצרים משתמש במסד הנתונים או משתמשים במשתמש קיים. הכינו את שם המשתמש והסיסמה.

שימוש בתוסף ל-Gemini CLI ל-PostgreSQL

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

השילוב עם Gemini CLI ל-AlloyDB Omni מתבצע באמצעות תוסף PostgreSQL. התוסף הזה מספק קבוצת כלים לאינטראקציה עם PostgreSQL ו-AlloyDB Omni, שמאפשרים לנהל את מסדי הנתונים, להריץ שאילתות ולחקור סכימות ישירות מ-Gemini CLI באמצעות הנחיות בשפה טבעית.

בדוגמאות הבאות נעשה שימוש במסד נתונים לדוגמה של ecommerce עם הטבלאות הבאות:

  • ‫products: מכיל פרטי המוצר, כולל product_id,‏ product_name,‏ category ו-price.
  • ‫customers: מאחסן נתוני לקוחות, כמו customer_id, first_name, last_name ו-email.
  • ‫orders: מכיל את פרטי ההזמנה, כולל order_id,‏ customer_id ו-order_date.

הכלים הבאים זמינים בתוסף PostgreSQL:

קטגוריה כלי דוגמה לפרומפט בשפה טבעית
פעולות במסד הנתונים execute_sql תראה לי את 10 המוצרים הכי יקרים בקטגוריה "מחשבים ניידים".
get_query_plan תסביר את תוכנית לביצוע שאילתה לשאילתה שמאתרת את כל הלקוחות שלא ביצעו הזמנה ב-6 החודשים האחרונים.
list_active_queries אילו שאילתות מורצות במסד הנתונים?
database_overview תן לי סקירה כללית של מסד הנתונים הנוכחי.
list_tables תציג לי את כל הטבלאות במסד הנתונים הנוכחי.
list_views אילו תצוגות זמינות?
list_schemas הצגת רשימה של כל הסכימות.
list_triggers תראה לי את הטריגרים בטבלת ההזמנות.
list_available_extensions אילו תוספים זמינים להתקנה?
list_installed_extensions מציגים את כל התוספים שמותקנים.
list_indexes הצגת רשימה של כל האינדקסים.
list_sequences רשימה של כל הרצפים.
תקינות ותחזוקה של מסד הנתונים list_autovacuum_configurations תראה לי את ההגדרה הנוכחית של autovacuum.
list_memory_configurations מהן הגדרות הזיכרון הנוכחיות?
list_top_bloated_tables הצגת רשימה של חמש הטבלאות הכי מנופחות.
list_replication_slots הצגת כל משבצות הרפליקציה הפעילות.
list_invalid_indexes צריך לבדוק אם יש אינדקסים לא חוקיים במסד הנתונים של ecommerce.
long_running_transactions תראה לי את העסקאות שפועלות לאורך זמן.
list_locks מפרטים את כל הנעילות.
replication_stats תראה לי את הנתונים הסטטיסטיים של הרפליקציה.

אתם יכולים להשתמש בתוסף ל-Gemini CLI ל-PostgreSQL בשתי דרכים:

  • כלי עצמאי של שורת הפקודה
  • משולב ב-IDE שלכם עם Gemini Code Assist

Gemini CLI

  1. מתקינים את Gemini CLI (גרסה 0.6.0 ואילך).
  2. מתקינים את התוסף PostgreSQL ל-Gemini CLI מהמאגר ב-GitHub באמצעות הפקודה הבאה: 
    gemini extensions install https://github.com/gemini-cli-extensions/postgres
  3. מגדירים משתני סביבה כדי להתחבר למכונה של AlloyDB Omni: 
    export POSTGRES_HOST="DATABASE_HOST"
export POSTGRES_PORT="DATABASE_PORT"
export POSTGRES_DATABASE="DATABASE_NAME"
export POSTGRES_USER="DATABASE_USER"
export POSTGRES_PASSWORD="DATABASE_PASSWORD"

    אפשר גם לטעון את המשתנים האלה מקובץ .env בספריית העבודה.

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

Gemini Code Assist

כדי להימנע מהגדרה ידנית של שרת MCP, מגדירים את Gemini Code Assist לשימוש ב-Gemini CLI.

  1. מתקינים ומגדירים את Gemini CLI ואת התוסף postgres, כמו שמתואר בכרטיסייה Gemini CLI.
  2. איך מגדירים את Gemini Code Assist לשימוש ב-Gemini CLI
  3. מתחילים לקיים אינטראקציה עם מופע AlloyDB Omni באמצעות שפה טבעית ישירות בצ'אט של Gemini Code Assist.

חיבור לסביבות פיתוח משולבות (IDE) אחרות באמצעות MCP Toolbox for Databases

בקטע הזה מוסבר איך להתחבר למופע AlloyDB Omni מסוכנים שונים באמצעות MCP Toolbox for Databases.

התקנת MCP Toolbox for Databases

כדי לחבר את סביבת הפיתוח המשולבת (IDE) ל-AlloyDB Omni, צריך להתקין את MCP Toolbox for Databases, שרת קוד פתוח שמחבר סוכני AI לנתונים שלכם.

  1. מורידים את הגרסה העדכנית של Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה (OS) ולארכיטקטורת המעבד (CPU).

    linux/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/linux/amd64/toolbox

    darwin/arm64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/darwin/arm64/toolbox

    darwin/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/darwin/amd64/toolbox

    windows/amd64

    curl -L -O https://storage.googleapis.com/genai-toolbox/v0.21.0/windows/amd64/toolbox.exe

  2. הופכים את הקובץ הבינארי לקובץ הפעלה.

    chmod +x toolbox

  3. מאמתים את ההתקנה.

    ./toolbox --version

הגדרת הלקוח

בוחרים את כלי הנציג מבין האפשרויות הבאות:

סמן

  1. יוצרים את הספרייה .cursor בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
  2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP (הגדרות > הגדרות Cursor > MCP). כשהשרת מתחבר, מופיע סטטוס פעיל בצבע ירוק.

גלישת רוח

  1. פותחים את Windsurf ועוברים אל Cascade assistant.
  2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}

‫Visual Studio Code ‏ (Copilot)

  1. פותחים את VS Code ויוצרים ספריית .vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
  2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "servers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}

קלינה

  1. פותחים את התוסף Cline ב-VS Code ולוחצים על סמל שרתי MCP.
  2. לוחצים על הגדרת שרתי MCP כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרות הבאות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. אחרי שהשרת יתחבר בהצלחה, יופיע סטטוס פעיל בצבע ירוק.

Claude במחשב

  1. פותחים את Claude Desktop ועוברים אל הגדרות.
  2. בכרטיסייה Developer, לוחצים על Edit Config כדי לפתוח את קובץ התצורה.
  3. מוסיפים את ההגדרות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. מפעילים מחדש את Claude Desktop.
  2. במסך הצ'אט החדש מופיע סמל פטיש (MCP) עם שרת ה-MCP החדש.

Claude code

  1. מתקינים את Claude Code.
  2. יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
  3. מוסיפים את ההגדרות, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "alloydbomni": {
      "command": "PATH_TO_TOOLBOX",
      "args": ["--prebuilt","postgres","--stdio"],
      "env": {
        "POSTGRES_HOST": "DATABASE_HOST",
        "POSTGRES_PORT": "DATABASE_PORT",
        "POSTGRES_DATABASE": "DATABASE_NAME",
        "POSTGRES_USER": "DATABASE_USER",
        "POSTGRES_PASSWORD": "DATABASE_PASSWORD"
      }
    }
  }
}
  1. מפעילים מחדש את Claude Code כדי להחיל את ההגדרות האישיות החדשות.