MCP Tools Reference: developerconnect.googleapis.com

Tool: fetch-repo-pull-request

Details zu einer bestimmten Pull-Anfrage aus einem Git-Repository abrufen.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool fetch-repo-pull-request 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",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für FetchGitRepositoryLinkPullRequest.

FetchGitRepositoryLinkPullRequestRequest

JSON-Darstellung 
{
  "name": string,
  "pullRequestId": string
}
Felder
name

string

Pflichtangabe. Der Ressourcenname des GitRepositoryLink im Format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Pflichtangabe. Die ID des Pull-Requests.

Ausgabeschema

Nachricht, die eine SCM-Pull-Anfrage darstellt.

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: ❌