MCP Tools Reference: developerconnect.googleapis.com

כלי: fetch-repo-commit-list

אחזור רשימה של קומיטים ממאגר Git.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ fetch-repo-commit-list.

בקשת 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": "fetch-repo-commit-list",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הודעת בקשה ל-FetchGitRepositoryLinkCommitList.

FetchGitRepositoryLinkCommitListRequest

ייצוג ב-JSON 
{
  "name": string,
  "ref": string,
  "pageSize": integer,
  "pageToken": string,
  "view": enum (CommitView)
}
שדות
name

string

חובה. שם המשאב של GitRepositoryLink בפורמט projects/*/locations/*/connections/*/gitRepositoryLinks/*.
ref

string

זה שינוי אופציונלי. ה-SHA של השמירה או הגרסה הסמלית (לדוגמה, שם ההסתעפות, התג או ההפניה ל-Git) שמהם מתחילים להציג את השמירות.
pageSize

integer

זה שינוי אופציונלי. מספר התוצאות שיוחזרו ברשימה. ברירת המחדל היא 50. המספר המקסימלי הוא 100.
pageToken

string

זה שינוי אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של FetchGitRepositoryLinkCommitList. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו ל-FetchGitRepositoryLinkCommitList חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.
view

enum (CommitView)

זה שינוי אופציונלי. רמת הפירוט של פרטי השמירה שיופיעו בתשובה. יש תמיכה רק ב-BASIC. הערך FULL מחזיר את INVALID_ARGUMENT. אם לא צוין ערך, ברירת המחדל היא BASIC. כדי לקבל את ההבדלים בין הקבצים ב-commit יחיד, משתמשים ב-FetchGitRepositoryLinkCommit.

CommitView

רמת הפירוט של פרטי השמירה שיופיעו בתשובה.

טיפוסים בני מנייה (enum)
COMMIT_VIEW_UNSPECIFIED לא צוין, ברירת המחדל היא BASIC.
BASIC תצוגה בסיסית, מחזירה מטא-נתונים של commit אבל לא הבדלים בין קבצים.
FULL תצוגה מלאה, מחזירה מטא-נתונים של השמירה והשוואות בין קבצים.

סכימת הפלט

הודעת תגובה ל-FetchGitRepositoryLinkCommitList.

FetchGitRepositoryLinkCommitListResponse

ייצוג ב-JSON 
{
  "commits": [
    {
      object (SCMCommit)
    }
  ],
  "nextPageToken": string
}
שדות
commits[]

object (SCMCommit)

רשימת המטא-נתונים של הקומיט.
nextPageToken

string

טוקן שאפשר לשלוח כ-page_token כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

SCMCommit

ייצוג ב-JSON 
{
  "sha": string,
  "message": string,
  "author": string,
  "authorEmail": string,
  "commitTime": string,
  "url": string
}
שדות
sha

string

‫SHA מלא של 40 תווים של SCM commit.
message

string

טקסט של הודעת השמירה.
author

string

השם המוצג של המחבר.
authorEmail

string

כתובת האימייל של המחבר.
commitTime

string (Timestamp format)

חותמת הזמן של יצירת ה-commit.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
url

string

קישור לכתובת ה-URL ב-HTML של ספק ה-SCM עבור ה-commit הזה.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (טווח שמתאים ל-‎0001-01-01T00:00:00Z עד ‎9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציה של ננו-שנייה. השדה הזה הוא החלק של הננו-שניות במשך הזמן, ולא חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שנספרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

הערות לגבי הכלים

הערות הכלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כלא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשה לאישור.

בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:

  • ‫readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌