שימוש ב-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 למאגרים ומכונה פעילה של מסד נתונים.
  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 כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת המעבד.

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

Cline

  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 כדי להחיל את ההגדרה החדשה.