כלי: list-repo-links
הצגת רשימה של קישורים למאגרי Git בחיבור.
בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP list-repo-links.
| בקשת Curl |
|---|
curl --location 'https://developerconnect.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list-repo-links", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
סכימת הקלט
הודעה לבקשת רשימה של GitRepositoryLinks
ListGitRepositoryLinksRequest
| ייצוג ב-JSON |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| שדות | |
|---|---|
parent |
חובה. ערך ההורה של ListGitRepositoryLinksRequest. |
pageSize |
זה שינוי אופציונלי. גודל הדף המבוקש. יכול להיות שהשרת יחזיר פחות פריטים מהמספר שביקשתם. אם לא צוין, השרת יבחר ברירת מחדל מתאימה. |
pageToken |
זה שינוי אופציונלי. אסימון שמזהה את דף התוצאות שהשרת צריך להחזיר. |
filter |
זה שינוי אופציונלי. המערכת מסננת את התוצאות. |
orderBy |
זה שינוי אופציונלי. רמז לגבי סדר התוצאות. |
סכימת הפלט
הודעה לתגובה להצגת GitRepositoryLinks
ListGitRepositoryLinksResponse
| ייצוג ב-JSON |
|---|
{
"gitRepositoryLinks": [
{
object ( |
| שדות | |
|---|---|
gitRepositoryLinks[] |
רשימת הקישורים למאגרי Git. |
nextPageToken |
אסימון שמזהה את דף התוצאות שהשרת צריך להחזיר. |
unreachable[] |
מיקומים שלא ניתן להגיע אליהם. |
GitRepositoryLink
| ייצוג ב-JSON |
|---|
{ "name": string, "cloneUri": string, "createTime": string, "updateTime": string, "deleteTime": string, "labels": { string: string, ... }, "etag": string, "reconciling": boolean, "annotations": { string: string, ... }, "uid": string, "webhookId": string, "gitProxyUri": string } |
| שדות | |
|---|---|
name |
מזהה. שם המשאב של המאגר, בפורמט |
cloneUri |
חובה. URI של Git Clone. |
createTime |
פלט בלבד. חותמת זמן היצירה. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
updateTime |
פלט בלבד. עדכון חותמת הזמן. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
deleteTime |
פלט בלבד. מחיקת חותמת הזמן. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
labels |
זה שינוי אופציונלי. תוויות כצמדי מפתח/ערך אובייקט שמכיל רשימה של זוגות |
etag |
זה שינוי אופציונלי. סיכום הביקורת הזה מחושב על ידי השרת על סמך הערך של שדות אחרים, ויכול להיות שיישלח בבקשות עדכון ומחיקה כדי לוודא שללקוח יש ערך עדכני לפני שממשיכים. |
reconciling |
פלט בלבד. צריך להגדיר את הערך כ-true כשהחיבור מוגדר או מתעדכן ברקע. |
annotations |
זה שינוי אופציונלי. מאפשר ללקוחות לאחסן כמויות קטנות של נתונים שרירותיים. אובייקט שמכיל רשימה של זוגות |
uid |
פלט בלבד. מזהה ייחודי שהמערכת מקצה ל-GitRepositoryLink. |
webhookId |
פלט בלבד. המזהה החיצוני של ה-webhook שנוצר למאגר. |
gitProxyUri |
פלט בלבד. URI לגישה למאגר המקושר דרך שרת ה-proxy של Git. השדה הזה מאוכלס רק אם שרת ה-proxy של Git מופעל בחיבור. |
חותמת הזמן
| ייצוג ב-JSON |
|---|
{ "seconds": string, "nanos": integer } |
| שדות | |
|---|---|
seconds |
מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) 1970-01-01T00:00:00Z. הערך חייב להיות בין -62135596800 ל-253402300799, כולל (טווח שמתאים ל-0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z). |
nanos |
שברים לא שליליים של שנייה ברזולוציה של ננו-שנייה. השדה הזה הוא החלק של הננו-שניות במשך הזמן, ולא חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שנספרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל. |
LabelsEntry
| ייצוג ב-JSON |
|---|
{ "key": string, "value": string } |
| שדות | |
|---|---|
key |
|
value |
|
AnnotationsEntry
| ייצוג ב-JSON |
|---|
{ "key": string, "value": string } |
| שדות | |
|---|---|
key |
|
value |
|
הערות לגבי הכלים
הערות הכלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כלא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשה לאישור.
בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:
-
readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false. -
destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true. -
idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false. -
openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌