MCP Reference: developerknowledge.googleapis.com

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

הגדרת השרת

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

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

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

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

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

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית 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

  • ‫Genkit: ‏ genkit.dev

  • ‫Go: ‏ go.dev

  • ‫Google AI: ‏ ai.google.dev

  • ‫Google Antigravity: ‏ antigravity.google

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

  • ‫Google Developers, ‏ Ads, חיפוש, מפות Google, ‏ YouTube: ‏ developers.google.com

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

  • Google Maps Platform‏: mapsplatform.google.com

  • ‫Google Workspace: ‏ knowledge.workspace.google.com

  • ‫TensorFlow: ‏ www.tensorflow.org

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

הכלי הזה מחזיר קטעי טקסט, שמות וכתובות URI של מסמכים תואמים. עדיף להשתמש ב-search_documents ואז ב-get_documents כשצריך דוגמאות קוד מדויקות, דגלי CLI, הודעות שגיאה ספציפיות, מדריכים מפורטים או חיפוש מילות מפתח דטרמיניסטי. אם קטעי הטקסט שמוחזרים לא מפורטים מספיק כדי לענות על השאלה של המשתמש, צריך להשתמש ב-get_documents עם ה-parent מהפלט של הכלי הזה כדי לאחזר את תוכן המסמך המלא. כשעונים למשתמש, תמיד צריך לצטט את שמות המשאבים (documents/...) או את ה-URI של מסמכי המקור המהימנים.
answer_query

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

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

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

כדי לקבל את המפרטים של כל הכלים בשרת MCP, משתמשים ב-method‏ 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
}'