MCP Reference: developerknowledge.googleapis.com

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

הגדרת השרת

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

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

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

לשרת ה-MCP של Developer Knowledge API יש את נקודת הקצה הגלובלית הבאה של MCP:

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

כלי MCP

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

כלים

בשרת ה-MCP developerknowledge.googleapis.com יש את הכלים הבאים:

כלי MCP
search_documents

אפשר להשתמש בכלי הזה כדי למצוא מאמרי עזרה על מוצרים של Google למפתחים. במסמכים מפורטים ממשקי API רשמיים, קטעי קוד, נתוני גרסה, שיטות מומלצות, מדריכים, פרטי ניפוי באגים ועוד. המאמר מתייחס למוצרים ולדומיינים הבאים:

  • ADK: adk.dev

  • ‫Android: developer.android.com

  • ‫Apigee: docs.apigee.com

  • ‫Chrome: developer.chrome.com

  • ‫Dart: dart.dev

  • ‫Firebase: firebase.google.com

  • ‫Flutter: docs.flutter.dev

  • Fuchsia: ‏ fuchsia.dev

  • ‫Gemini CLI: ‏ geminicli.com

  • ‫Go: ‏ go.dev

  • ‫Google AI: ai.google.dev

  • ‫Google Antigravity: ‏ antigravity.google

  • ‫Google Cloud: ‏ cloud.google.com ו-docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, Youtube: developers.google.com

  • ‫Google Home: developers.home.google.com

  • Google Maps Platform: ‏ mapsplatform.google.com

  • ‫TensorFlow: www.tensorflow.org

  • אינטרנט: web.dev

הכלי הזה מחזיר נתחים של טקסט, שמות וכתובות URL של מסמכים תואמים. אם המקטעים שמוחזרים לא מספקים מספיק פרטים כדי לענות על השאלה של המשתמש, צריך להשתמש ב-get_documents עם parent מהפלט של הכלי הזה כדי לאחזר את התוכן המלא של המסמך.
answer_query

אפשר להשתמש בפונקציה answer_query כדי לקבל תשובה מבוססת לשאלה לגבי מוצרים של Google למפתחים. לכלי הזה יש מכסת שימוש מוגבלת. הכלי הזה יסנתז מידע מהמאגר כדי ליצור תשובה לשאילתה. התשובה לשאילתה מבוססת על אותו מאגר כמו search_documents. הכלי הזה מחזיר את התשובה שנוצרה (answer_text) ואת רשימת שמות המסמכים (references) ששימשו ליצירת התשובה. אם צריך, אפשר להשתמש ב-get_documents עם שמות המסמכים כדי לאחזר את התוכן המלא של המסמך.

אם מתקבלת שגיאת חריגה ממכסה (429), צריך להשתמש ב-search_documents.
get_documents אתם יכולים להשתמש בכלי הזה כדי לאחזר את התוכן המלא של מסמך אחד או עד 20 מסמכים בשיחה אחת. שמות המסמכים צריכים להתקבל מהשדה parent בתוצאות של קריאה לכלי search_documents. מגדירים את הפרמטר names לרשימה של שמות מסמכים.

קבלת מפרטים של כלי ה-MCP

כדי לקבל את המפרטים של כלי ה-MCP לכל הכלים בשרת MCP, משתמשים בשיטה tools/list. בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להציג רשימה של כל הכלים והמפרטים שלהם שזמינים כרגע בשרת ה-MCP.

בקשת Curl 
                      
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'