MCP Reference: vectorsearch.googleapis.com

שרת MCP ל-Agent Retrieval (לשעבר חיפוש וקטורי 2.0), שמספק כלים לצפייה באוספים ובאינדקסים, לשליחת שאילתות ולביצוע חיפושים.

שרת Model Context Protocol‏ (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים בין אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.

הגדרת השרת

לפני השימוש, צריך להפעיל את שרתי ה-MCP ולהגדיר אימות. איך משתמשים בשרת MCP מרוחק של Agent Retrieval מידע כללי על השימוש בשרתי MCP מרוחקים של Google ו-Google Cloud זמין במאמר סקירה כללית על שרתי MCP של Google Cloud.

נקודות קצה של שרתים

נקודת קצה של שירות MCP היא כתובת הרשת וממשק התקשורת (בדרך כלל כתובת URL) של שרת ה-MCP, שבהם אפליקציית AI (המארח של לקוח ה-MCP) משתמשת כדי ליצור חיבור מאובטח וסטנדרטי. הוא משמש כנקודת הקשר של ה-LLM לבקשת הקשר, להפעלת כלי או לגישה למשאב. נקודות הקצה של Google MCP יכולות להיות גלובליות או אזוריות.

שרת ה-MCP של Agent Retrieval (חיפוש וקטורי API) חושף נקודת קצה אחת של MCP:

• https://vectorsearch.googleapis.com/mcp

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.

שרת ה-MCP של Agent Retrieval חושף כרגע את הכלים הבאים בנקודת הקצה היחידה /mcp. אם אתם משתמשים בפרוטוקול ללא שמירת מצב MCP 2026-07-28, כל בקשת tools/call צריכה לכלול גם כותרת HTTP מסוג Mcp-Name שהערך שלה שווה ל-params.name (ול-Mcp-Param-Region לניתוב אזורי ישיר; ראו ניתוב מבוסס-כותרת). אל תשלחו את Mcp-Name עם tools/list. אפשר גם לשלוח בקשות שמשתמשות בגרסאות קודמות של פרוטוקול MCP, כמו הדוגמאות של curl בדפי הכלים (עם כותרת Authorization: Bearer).

• ‫list_collections – הצגת רשימה של אוספי החיפוש הווקטורי בפרויקט ובמיקום.
• ‫get_collection – אחזור הסכימה והמטא-נתונים של אוסף ספציפי.
• ‫list_indexes – אינדקסים של רשימות שמוגדרים באוסף.
• ‫get_index – אחזור ההגדרות של אינדקס ספציפי.
• ‫get_data_object – אחזור של אובייקט נתונים מאוסף לפי מזהה.
• ‫search_data_objects – הרצת חיפוש וקטורי, סמנטי או חיפוש טקסט באוסף.
• ‫query_data_objects – הצגת רשימה של אובייקטי נתונים שתואמים לביטוי סינון.
• ‫batch_search_data_objects – הפעלת כמה חיפושים במקביל ומיזוג התוצאות באמצעות Reciprocal Rank Fusion‏ (RRF) או Vertex Ranking API.
• aggregate_data_objects – אובייקטים של נתונים נצברים שתואמים לביטוי של מסנן (לדוגמה, ספירות).

curl -X POST 'https://vectorsearch.googleapis.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/list' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'