MCP Tools Reference: developerconnect.googleapis.com

כלי: modify-repo-pull-request

משנים בקשת משיכה במאגר ה-SCM המרוחק.

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

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

סכימת הקלט

הודעה לשינוי בקשת משיכה (Pull Request) של SCM.

ModifyGitRepositoryLinkPullRequestRequest

ייצוג ב-JSON 
{
  "name": string,
  "pullRequestId": string,
  "title": string,
  "body": string,
  "baseRef": string,
  "state": enum (State)
}
שדות
name

string

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

string

חובה. מזהה בקשת המשיכה (pull request) הספציפי ל-SCM (לדוגמה, "45").
title

string

זה שינוי אופציונלי. הכותרת של בקשת המשיכה (pull request).
body

string

זה שינוי אופציונלי. תיאור הגוף של בקשת משיכה (pull request).
baseRef

string

זה שינוי אופציונלי. הענף שאליו רוצים למזג.
state

enum (State)

זה שינוי אופציונלי. מצב בקשת משיכה (pull request).

מדינה

השדה State מייצג את המצב של בקשת משיכה (pull request).

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
OPEN בקשת משיכה (pull request) פתוחה.
CLOSED בקשת משיכה (pull request) נסגרת.

סכימת הפלט

הודעה שמייצגת בקשת משיכה (Pull Request) ב-SCM.

PullRequest

ייצוג ב-JSON 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
שדות
id

string

חובה. המזהה של בקשת ה-Pull.
title

string

חובה. השם של בקשת ה-Pull.
body

string

זה שינוי אופציונלי. תיאור הגוף של בקשת ה-Pull.
headRef

string

חובה. ה-SHA של השמירה במקור של הענף הראשי.
baseRef

string

חובה. ה-SHA של ה-commit ל-base branch.
author

string

פלט בלבד. שם המשתמש של המחבר.
createTime

string (Timestamp format)

פלט בלבד. מתי נוצרה בקשת ה-Pull.

הפורמט הוא 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".
updateTime

string (Timestamp format)

פלט בלבד. מתי בקשת ה-PR עודכנה.

הפורמט הוא 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".
mergeTime

string (Timestamp format)

פלט בלבד. מתי בקשת ה-Pull מוזגה.

הפורמט הוא 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".
closeTime

string (Timestamp format)

פלט בלבד. מתי בקשת ה-PR נסגרה.

הפורמט הוא 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".
declineTime

string (Timestamp format)

פלט בלבד. מתי בקשת התיקון נדחתה. ההגדרה הזו רלוונטית רק לספקי SCM שתומכים בדחיית בקשות משיכה. הערך הזה אף פעם לא מוגדר ל-GitHub, ל-GitHub Enterprise, ל-GitLab או ל-GitLab Enterprise, שבהם בקשת משיכה שנסגרה בלי מיזוג היא CLOSED.

הפורמט הוא 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".
state

enum (State)

פלט בלבד. המצב הנוכחי של בקשת ה-Pull.
mergeability

enum (Mergeability)

פלט בלבד. מצב המיזוג של בקשת המשיכה.
htmlUrl

string

פלט בלבד. כתובת ה-HTML של בקשת משיכה (pull request) אצל ספק ה-SCM.

חותמת הזמן

ייצוג ב-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, כולל.

מדינה

הסטטוס של בקשת ה-Pull.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל.
OPEN בקשת ה-PR פתוחה.
CLOSED בקשת ה-PR נסגרה.
MERGED בקשת ה-PR מוזגה.
DECLINED בקשת ה-PR נדחית. ההרשאה הזו משמשת רק ספקי SCM שתומכים בדחיית בקשות משיכה. הערך הזה לא משמש אף פעם ל-GitHub, ל-GitHub Enterprise, ל-GitLab או ל-GitLab Enterprise, שבהם בקשת משיכה שנסגרה בלי מיזוג היא CLOSED.

אפשרות מיזוג

מצב המיזוג של בקשת משיכה.

טיפוסים בני מנייה (enum)
MERGEABILITY_UNSPECIFIED לא צוין מצב יכולת המיזוג.
MERGEABLE אפשר למזג את בקשת משיכה (pull request) בצורה נקייה בלי התנגשויות ב-Git.
CONFLICTING יש בבקשת ה-pull התנגשויות מיזוג, ואי אפשר למזג אותה בצורה נקייה.
COMPUTING מצב המיזוג מחושב כרגע באופן אסינכרוני על ידי ספק ה-SCM במעלה הזרם.

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

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

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

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

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