MCP Tools Reference: developerconnect.googleapis.com

Tool: fetch-repo-pull-request-list

Ruft eine Liste von Pull-Anfragen aus einem Git-Repository ab.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool fetch-repo-pull-request-list aufrufen.

Curl-Anfrage 
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-pull-request-list",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für FetchGitRepositoryLinkPullRequestList.

FetchGitRepositoryLinkPullRequestListRequest

JSON-Darstellung 
{
  "name": string,
  "filter": string,
  "pageSize": integer,
  "pageToken": string
}
Felder
name

string

Pflichtangabe. Der Name der GitRepositoryLink-Ressource im Format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
filter

string

Optional. Ein Filterausdruck, der die in der Antwort zurückgegebenen Pull-Anfragen filtert. Es wird nur ein einziger Gleichheitsvergleich für state unterstützt, z. B. state = "OPEN". Unterstützte Werte sind OPEN, CLOSED, und MERGED. DECLINED wird nur für SCM-Anbieter unterstützt, die das Ablehnen von Pull-Anfragen unterstützen, und gibt INVALID_ARGUMENT für GitHub, GitHub Enterprise, GitLab und GitLab Enterprise zurück. Andere Werte oder Ausdrücke geben INVALID_ARGUMENT zurück. Wenn keine Angabe gemacht wird, ist der Standardwert state = "OPEN".
pageSize

integer

Optional. Anzahl der Ergebnisse, die in der Liste zurückgegeben werden sollen. Der Standardwert ist 20. Der Höchstwert ist 100. Eine Seite kann weniger als page_size Ergebnisse enthalten, auch wenn mehr Ergebnisse verfügbar sind. Verwenden Sie next_page_token, um nach weiteren Seiten zu suchen.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen FetchGitRepositoryLinkPullRequestList-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Ausgabeschema

Antwortnachricht für FetchGitRepositoryLinkPullRequestList.

FetchGitRepositoryLinkPullRequestListResponse

JSON-Darstellung 
{
  "pullRequests": [
    {
      object (PullRequest)
    }
  ],
  "nextPageToken": string
}
Felder
pullRequests[]

object (PullRequest)

Die Liste der Pull-Anfragen.
nextPageToken

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

PullRequest

JSON-Darstellung 
{
  "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
}
Felder
id

string

Pflichtangabe. Die ID des PR.
title

string

Pflichtangabe. Der Titel des PR.
body

string

Optional. Die Beschreibung des PR.
headRef

string

Pflichtangabe. Der Quell-Commit-SHA des Head-Zweigs.
baseRef

string

Pflichtangabe. Der Ziel-Commit-SHA des Basis-Zweigs.
author

string

Nur Ausgabe. Der Nutzername des Autors.
createTime

string (Timestamp format)

Nur Ausgabe. Wann der PR erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Wann der PR aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
mergeTime

string (Timestamp format)

Nur Ausgabe. Wann der PR zusammengeführt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
closeTime

string (Timestamp format)

Nur Ausgabe. Wann der PR geschlossen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
declineTime

string (Timestamp format)

Nur Ausgabe. Wann der PR abgelehnt wurde. Wird nur für SCM-Anbieter festgelegt, die das Ablehnen von Pull-Anfragen unterstützen. Wird nie für GitHub, GitHub Enterprise, GitLab oder GitLab Enterprise festgelegt, da eine Pull-Anfrage, die ohne Zusammenführung geschlossen wird, CLOSED ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
state

enum (State)

Nur Ausgabe. Der aktuelle Status des PR.
mergeability

enum (Mergeability)

Nur Ausgabe. Der Zusammenführbarkeitsstatus der Pull-Anfrage.
htmlUrl

string

Nur Ausgabe. Die HTML-URL der Pull-Anfrage beim SCM-Anbieter.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 (einschließlich) liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekunden-Teil der Dauer, keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 (einschließlich) liegen.

Bundesland

Der Status des PR.

Enums
STATE_UNSPECIFIED Standardwert.
OPEN Der PR ist offen.
CLOSED Der PR ist geschlossen.
MERGED Der PR wird zusammengeführt.
DECLINED Der Pull-Request wird abgelehnt. Wird nur von SCM-Anbietern verwendet, die das Ablehnen von Pull-Anfragen unterstützen. Wird nie für GitHub, GitHub Enterprise, GitLab oder GitLab Enterprise verwendet, wo eine Pull-Anfrage, die ohne Zusammenführung geschlossen wurde, CLOSED ist.

Zusammenführbarkeit

Der Zusammenführbarkeitsstatus einer Pull-Anfrage.

Enums
MERGEABILITY_UNSPECIFIED Der Zusammenführbarkeitsstatus ist nicht angegeben.
MERGEABLE Der Pull-Anfrage kann ohne Git-Konflikte zusammengeführt werden.
CONFLICTING Der Pull-Anfrage weist Zusammenführungskonflikte auf und kann nicht sauber zusammengeführt werden.
COMPUTING Der Zusammenführungsstatus wird derzeit asynchron vom Upstream-SCM-Anbieter berechnet.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise ein Open-World-Tool, ein Tool für gemerkte Informationen dagegen nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Lesezugriff-Hinweis: ✅ | Open-World-Hinweis: ❌